mcpField
I
iconify-skill

iconify-skill

github.com/bingalデザイン・UI471 回インストール27 週間前に更新
リポジトリ

iconify-skill について

iconify-skillは、SVGアイコンの検索、提案、取得に使うPythonコマンドラインスキルです。厳選コレクションのオフラインインデックスとオンライン検索・取得を組み合わせています。

主な機能

  1. 01オフラインとオンラインでアイコン検索
  2. 02意図に応じたアイコン提案
  3. 03スタイルを指定してSVGを取得
  4. 04アイコンコレクションの一覧表示
  5. 05環境とインデックスの確認
  6. 06帰属表示情報の確認

活用シーン

  1. 01インターフェース要素のアイコン探し
  2. 02機能の案に合うアイコンの検討
  3. 03スタイル指定でSVGを取得

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/iconify-skillを入力して読み込まれたか確認します。

同梱ファイル

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

詳細

Iconify スキル

アイコンの検索、提案、取得には、scripts/iconify_cli.py の CLI を使用します。

クイックスタート

  1. Python 3 が利用できることを確認します。
  2. doctor を実行して環境を検証します。
  3. オフラインインデックスがない場合は、ビルドします。
python3 $SKILL_DIR/scripts/iconify_cli.py doctor

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

コマンドインターフェース

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

よく使うコマンド

  • list-collections - アイコンセットを一覧表示します
  • search <query> - アイコンを検索します（オフラインのキュレーション済みインデックス＋オンラインフォールバック）
  • get <prefix:name> - SVG を取得します（ネットワークが必要です）
  • suggest "<intent>" - 意図に合ったアイコンを提案します
  • attribution - ライセンス情報を表示します
  • doctor - システムのヘルスチェックを実行します

使用例

# 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

オフライン利用とデータに関する注意事項

  • search はキュレーション済みセット（約 32K 個のアイコン）に対して同梱の SQLite インデックスを使用し、より幅広く検索できるよう、Iconify のオンライン検索 API に自動的にフォールバックします。
  • get にはネットワークアクセスが必要です（Iconify API／GitHub raw JSON）。
  • キャッシュとインデックスが利用可能かどうかは、doctor で確認してください。
  • 必要に応じて、build-index で検索インデックスを再生成してください。

同梱コレクション（約 32K 個のアイコン）

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

これらのキュレーション済みの MIT／ISC ライセンスのセットは、高速なオフライン検索のために同梱されています。この一覧に含まれない結果は、Iconify のオンライン検索 API 経由で取得されます。

出力形式

終了コード
  • 0 - 成功
  • 1 - アイコンが見つからない／引数が無効
  • 2 - ネットワークエラー（get コマンド）
  • 3 - データベースエラー（オフラインモード）
SVG 出力
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
  <path fill="#3B82F6" d="..."/>
</svg>

参考資料

  • アーキテクチャの詳細、CLI の動作、キャッシュパス、エラー処理については、references/REFERENCE.md をお読みください。
  • ライセンス要件については、references/LICENSES_AND_ATTRIBUTION.md をお読みください。

コメント

Markdown 対応