Agent skill

Better Icons

by dtsola in dtsola/xiaoyaosearch

Searches more than 200 Iconify icon libraries and fetches icons as SVG from a command line tool or an MCP server.

Custom licenceAuto-check passedFrontend & Design

Install Better Icons

skills CLI
$ npx skills add dtsola/xiaoyaosearch --skill better-icons -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dtsola/xiaoyaosearch better-icons --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/better-icons .claude/skills/better-icons && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
better-icons
GitHub stars
1k
Used in
2 other repos
Token cost
~895 tokens
SKILL.md length
155 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

Searches more than 200 Iconify icon libraries and fetches icons as SVG from a command line tool or an MCP server.

  • Finding an icon for a button, menu or empty state
  • SKILL.md covers Installation, CLI, Examples and Icon ID Format, plus 4 more sections
  • Calls npx, bunx and npm; reaches api.iconify.design
  • Fetching a specific icon as an SVG file for a project

What it does

better-icons is a command line tool, also usable as an MCP server, for finding icons across more than 200 libraries served by Iconify and fetching them as SVG. The search command returns matches, with options for a prefix filter, a result limit and JSON output, and the get command prints an icon's SVG, for example redirected into a file. Icon IDs have the form prefix:name, such as lucide:home or mdi:arrow-right.

The skill suggests installing the CLI globally with npm so the commands are on the path, or prefixing each command with npx or bunx. Popular collections it lists include lucide, mdi, heroicons, tabler, ph, ri, solar and iconamoon. As an MCP server it exposes tools for searching icons, getting one or many SVGs, listing collections, recommending icons for a use case, finding similar icons across collections, syncing an icon into a project file and scanning the icons a project uses. All icons come from api.iconify.design.

When your agent uses it

  • Finding an icon for a button, menu or empty state
  • Fetching a specific icon as an SVG file for a project
  • Comparing the same icon across collections such as lucide and tabler
  • Listing the icons a project already uses

Example prompts

  • “Search for arrow icons, then save the lucide home icon to icon.svg.”
  • “Find a settings icon in the heroicons set and add it to the sidebar component.”
  • “Scan the project to see which icons we use and from which collections.”

Requirements

  • The better-icons CLI via npm, npx or bunx
  • Network access to api.iconify.design

What it can do on your machine

Read from SKILL.md and the folder at commit 0a9c6fc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • bunx
    • npm
    • bun
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.iconify.design

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Better Icons loads about 895 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 155 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~895

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 155 words (~895 tokens).

“Search and retrieve icons from 200+ libraries via Iconify.”

— opening of SKILL.md by dtsola, Custom licence
name
better-icons

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/better-icons of dtsola/xiaoyaosearch.

Open the folder on GitHubat commit 0a9c6fc

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in dtsola/xiaoyaosearch, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Better Icons next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Better Icons compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Better Icons this skilldtsola/xiaoyaosearch1k2 repos~895Automated safety check: PassCustom licence
Frontend Build Timing Auditopenops-cloud/openops1.1k—~2.3kAutomated safety check: PassCustom licence
Managing MCP IndexComfy-Org/workflow_templates1.3k—~1.9kAutomated safety check: NotesMIT
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
DocsPrefectHQ/fastmcp28k—~1kAutomated safety check: PassApache-2.0

Similar skills

  • Frontend Build Timing Audit

    openops-cloud/openops

    Detects and diagnoses chunk-evaluation timing bugs in the Vite/rolldown production build of react-ui (works-in-dev / broken-in-build i18n regressions, missing UI labels, module-scope t()…

    1.1k GitHub stars~2.3k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Managing MCP Index

    Comfy-Org/workflow_templates

    Builds and maintains templates/index.mcp.json for Comfy Cloud MCP tools.

    1.3k GitHub stars~1.9k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed
  • Create Docs

    victorgarciaesgi/nuxt-typed-router

    Create complete documentation sites for projects. An agent skill from victorgarciaesgi/nuxt-typed-router.

    413 GitHub starsUsed in 2 repos~2.8k tokens
    Frontend & DesignAuto-check passed
  • Docs

    PrefectHQ/fastmcp

    Write or revise a page under docs/ for gofastmcp.com. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Typeui

    bergside/typeui

    Use TypeUI with Hermes Agent to access project design skills, brand kits, UI prompts, and layout variations through the TypeUI MCP server when creating or refining user interfaces.

    2k GitHub stars~474 tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed

More from dtsola/xiaoyaosearch

  • Video Podcast Maker

    dtsola/xiaoyaosearch

    Turns a topic into a 4K horizontal video podcast through research, scripting, text-to-speech, Remotion rendering and background music, and can learn styles from references.

    1k GitHub stars~3.4k tokensUpdated 9 days ago
    Auto-check passed
  • Excalidraw Diagram Generator

    dtsola/xiaoyaosearch

    Writes .excalidraw JSON diagrams and exports them to PNG or SVG through the Kroki API or a local Firefox-based CLI.

    1k GitHub stars~3.5k tokensUpdated 9 days ago
    Auto-check passed
  • Searches local files from an agent through the XiaoyaoSearch MCP server, using semantic, full-text, hybrid, image-similarity and voice queries.

    1k GitHub stars~836 tokensUpdated 9 days ago
    Auto-check passed

Questions about Better Icons

What does Better Icons do?

Searches more than 200 Iconify icon libraries and fetches icons as SVG from a command line tool or an MCP server. better-icons is a command line tool, also usable as an MCP server, for finding icons across more than 200 libraries served by Iconify and fetching them as SVG. The search command returns matches, with options for a prefix filter, a result limit and JSON output, and the get command prints an icon's SVG, for example redirected into a file.

When should I use Better Icons?

Better Icons fits situations like: finding an icon for a button, menu or empty state; fetching a specific icon as an SVG file for a project; comparing the same icon across collections such as lucide and tabler; listing the icons a project already uses.

How do I install Better Icons in Claude Code?

Run `npx skills add dtsola/xiaoyaosearch --skill better-icons -a claude-code`. Or copy the skill folder (.claude/skills/better-icons in dtsola/xiaoyaosearch) into .claude/skills/better-icons in your project. Claude Code loads it when a task matches its description.

How do I install Better Icons in Codex?

Run `npx skills add dtsola/xiaoyaosearch --skill better-icons -a codex`. Or copy the skill folder (.claude/skills/better-icons in dtsola/xiaoyaosearch) into .agents/skills/better-icons in your project. Codex loads it when a task matches its description.

Can I use Better Icons in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dtsola/xiaoyaosearch --skill better-icons -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/better-icons, .gemini/skills/better-icons, .github/skills/better-icons and .opencode/skills/better-icons in your project.

What does Better Icons need to run?

Going by SKILL.md and its folder, Better Icons needs the command-line tools its instructions call (npx, bunx, npm, bun and jq). Our summary lists: The better-icons CLI via npm, npx or bunx; Network access to api.iconify.design.

Does Better Icons access the network?

SKILL.md names 1 domain. In commands or code: api.iconify.design; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Better Icons safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Better Icons use?

Better Icons has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Better Icons use?

About 895 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Better Icons?

Skills that share tags, products or a category with Better Icons: Frontend Build Timing Audit (openops-cloud/openops, 1.1k stars), Managing MCP Index (Comfy-Org/workflow_templates, 1.3k stars), MCP Development (coollabsio/coolify, 63k stars) and Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Better Icons?

dtsola (a GitHub user) maintains it in dtsola/xiaoyaosearch, which has 1,036 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 2, 2026.

Source: dtsola/xiaoyaosearch on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.