better-icons
Use when working with icons in any project. Provides CLI for searching 200+ icon libraries (Iconify) and retrieving SVGs. Commands: `better-icons search <query>` to find icons, `better-icons get <id>` to get SVG. Also available as MCP server for AI agents.
npx skills add dtsola/xiaoyaosearch --skill better-icons --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Better Icons Search and retrieve icons from 200+ libraries via Iconify. ## Installation Before using any `better-icons` commands, ensure the tool is available in the environment. **Option 1 — Install globally (recommended, matches all examples below):** ```bash # Using npm npm install -g better-icons # Using Bun (faster) bun add -g better-icons ``` **Option 2 — Run without installing (prefix every command with `npx` or `bunx`):** ```bash # Using npx (npm) npx better-icons search arrow --limit 10 npx better-icons get lucide:home > icon.svg # Using bunx (Bun — faster) bunx better-icons search arrow --limit 10 bunx better-icons get lucide:home > icon.svg ``` > **For AI agents:** Prefer the global install so that `better-icons` is on `$PATH` and the commands below work as-is. Run the install step once during environment setup, then use the commands without `npx`/`bunx`. ## CLI ```bash # Search icons better-icons search <query> [--prefix <prefix>] [--limit <n>] [--json] # Search and download all found icons as SVG files better-icons search <query> -d [dir] [--color <color>] [--size <px>] # Get icon SVG (outputs to stdout) better-icons get <icon-id> [--color <color>] [--size <px>] [--j
- Installation
- CLI
- Examples
- Icon ID Format
- Popular Collections
- MCP Tools (for AI agents)
- TypeScript Interfaces
- API
Using npm npm install -g better-icons Using Bun (faster) bun add -g better-icons Using npx (npm) npx better-icons search arrow --limit 10 npx better-icons get lucide:home > icon.svg Using bunx (Bun — faster) bunx better-icons search arrow --limit 10 bunx better-icons get lucide:home > icon.svg
What does the better-icons skill do?
Use when working with icons in any project. Provides CLI for searching 200+ icon libraries (Iconify) and retrieving SVGs. Commands: `better-icons search <query>` to find icons, `better-icons get <id>` to get SVG. Also available as MCP server for AI agents.
How do I install it?
Run `npx skills add dtsola/xiaoyaosearch --skill better-icons --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From dtsola/xiaoyaosearch, a repository with 1,013 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.