mcpField
I
iconify-skill

iconify-skill

github.com/bingalDesign & UI471 installsUpdated 27w ago
Repository

About iconify-skill

iconify-skill is a Python CLI skill for searching, suggesting, and retrieving SVG icons. It combines an offline index of curated collections with online search and retrieval.

Key features

  1. 01Search icons offline and online
  2. 02Suggest icons from intent
  3. 03Fetch styled SVG files
  4. 04List icon collections
  5. 05Check environment and index
  6. 06Display attribution information

Use cases

  1. 01Find icons for interface elements
  2. 02Explore icons for a feature concept
  3. 03Retrieve an SVG with custom styling

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bingal/iconify-skill --skill iconify-skill

After installing, type/iconify-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
.gitattributes
LICENSE
pyproject.toml
pytest.ini
assets/
intent_keywords.json
curated_sets.txt
data/
collections.json
references/
LICENSES_AND_ATTRIBUTION.md
REFERENCE.md
scripts/
build_index.py
update_bundled_data.py
doctor.py
iconify_cli.py
tests/
test_iconify.py
__init__.py

Details

From the project README

Iconify Skill

Use the CLI in scripts/iconify_cli.py to search, suggest, and fetch SVG icons.

Quickstart

  1. Ensure Python 3 is available.
  2. Run doctor to validate the environment.
  3. If the offline index is missing, build it.
python3 $SKILL_DIR/scripts/iconify_cli.py doctor

python3 $SKILL_DIR/scripts/iconify_cli.py build-index

Command Interface

python3 $SKILL_DIR/scripts/iconify_cli.py <command> [arguments]

Common Commands

  • list-collections - List icon sets
  • search <query> - Search icons (offline curated index + online fallback)
  • get <prefix:name> - Get SVG (requires network)
  • suggest "<intent>" - Suggest icons for intent
  • attribution - Show license info
  • doctor - System health check

Usage Examples

# Search icons (offline)
python3 $SKILL_DIR/scripts/iconify_cli.py search "close button" --limit 5

# Get SVG with custom styling
python3 $SKILL_DIR/scripts/iconify_cli.py get mdi:home --size 24 --color "#3B82F6"

# Suggest icons for a feature
python3 $SKILL_DIR/scripts/iconify_cli.py suggest "user profile page"

# Filter by collection
python3 $SKILL_DIR/scripts/iconify_cli.py search "home" --prefixes lucide,heroicons

Offline + Data Notes

  • search uses the bundled SQLite index for curated sets (~32K icons) and automatically falls back to the Iconify online search API for broader coverage.
  • get needs network access (Iconify API / GitHub raw JSON).
  • Use doctor to confirm cache/index availability.
  • Use build-index to regenerate the search index if needed.

Bundled Collections (~32K icons)

mdi, ph, tabler, simple-icons, lucide, bi, heroicons, feather, radix-icons

These curated MIT/ISC-licensed sets are bundled for fast offline search. Results from outside this list are fetched via the Iconify online search API.

Output Format

Exit Codes
  • 0 - Success
  • 1 - No icons found / invalid arguments
  • 2 - Network error (get command)
  • 3 - Database error (offline mode)
SVG Output
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
  <path fill="#3B82F6" d="..."/>
</svg>
<!-- Icon: mdi:check -->
<!-- License: MIT -->

References

  • Read references/REFERENCE.md for architecture details, CLI behavior, cache paths, and error handling.
  • Read references/LICENSES_AND_ATTRIBUTION.md when you need license requirements.

Comments

Markdown supported