better-icons

Name: better-icons - Agent Skill
Rating: 3.4 (206 reviews)
Author: better-auth

206

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.

Download Folder View on GitHub

CLI Install

Recommended

Use the skills CLI to install this skill with one command. Auto-detects all installed AI assistants.

Method 1 - skills CLI

npx skills i better-auth/better-icons/skills

Method 2 - openskills (supports sync & update)

npx openskills install better-auth/better-icons

Auto-detects Claude Code, Cursor, Codex CLI, Gemini CLI, and more. One install, works everywhere.

Installation Path

Download and extract to one of the following locations:

~/.claude/skills/better-icons/

SKILL.md

Skill Instructions

Back

Run with Cloud Agent

No setup needed. Let our cloud agents run this skill for you.

Select Provider

Select Model

Claude Sonnet 4.5

$0.20/task

Best for coding tasks

No setup required

Better Icons

Search and retrieve icons from 200+ libraries via Iconify.

CLI

# Search icons
better-icons search <query> [--prefix <prefix>] [--limit <n>] [--json]
 
# Get icon SVG (outputs to stdout)
better-icons get <icon-id> [--color <color>] [--size <px>] [--json]
 
# Setup MCP server for AI agents
better-icons setup [-a cursor,claude-code] [-s global|project]

Examples

better-icons search arrow --limit 10
better-icons search home --json | jq '.icons[0]'
better-icons get lucide:home > icon.svg
better-icons get mdi:home --color '#333' --json

Icon ID Format

prefix:name - e.g., lucide:home, mdi:arrow-right, heroicons:check

Popular Collections

lucide, mdi, heroicons, tabler, ph, ri, solar, iconamoon

MCP Tools (for AI agents)

Tool	Description
`search_icons`	Search across all libraries
`get_icon`	Get single icon SVG
`get_icons`	Batch retrieve multiple icons
`list_collections`	Browse available icon sets
`recommend_icons`	Smart recommendations for use cases
`find_similar_icons`	Find variations across collections

TypeScript Interfaces

interface SearchIcons {
  query: string
  limit?: number        // 1-999, default 32
  prefix?: string       // e.g., 'mdi', 'lucide'
  category?: string     // e.g., 'General', 'Emoji'
}
 
interface GetIcon {
  icon_id: string

API

All icons from https://api.iconify.design