skill-toggle について
skill-toggleは、個人スキルとプラグインスキルをまとめて管理するコマンドラインツールです。Claudeのスキルを整理するユーザー向けに、状態確認、検索、クリーンアップ、名前付きコレクションによる一括切り替えを備えています。
主な機能
- 01個人スキルの有効化・無効化
- 02settings.jsonでのプラグインスキル切り替え
- 03スキルの一覧・詳細確認・あいまい検索
- 04孤立したファイルとディレクトリの整理
- 05スキルコレクションの作成と切り替え
活用シーン
- 01複数スキルの一時的な無効化
- 02名前や説明によるスキル検索
- 03有効なスキルのコレクション保存
- 04指定したグループの一括切り替え
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ tdimino/ claude-code-minoan --skill skill-toggleインストール後、Claude Code で/skill-toggleを入力して読み込まれたか確認します。
同梱ファイルREADME.mdscripts/skill_toggle.py
詳細
スキル切り替え
1 つの CLI から、個人スキルとプラグインスキルを管理します。
使い方
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py <command> [args]
コマンド
| コマンド | 操作 |
|---|---|
list | ステータス(有効/無効)、ソース、説明とともにすべてのスキルを表示します |
list --enabled | 有効なスキルのみを表示します |
list --disabled | 無効なスキルのみを表示します |
list --plugins | プラグインスキルのみを表示します |
disable <name> [name...] | 1 つ以上のスキルを無効にします(個人スキル:disabled/ に移動、プラグイン:settings.json を切り替え) |
enable <name> [name...] | 1 つ以上のスキルを有効にします(disable の逆の操作) |
status <name> | 指定したスキルの詳細を表示します |
search <query> | すべてのスキル名と説明をあいまい検索します |
clean | 孤立したディレクトリ(SKILL.md がないもの)、zip ファイル、古くなった .sh スクリプトを disabled/orphans/ に移動します |
collection list | スキル数とプラグイン数とともに、すべてのコレクションを表示します |
collection create <name> <skills...> | 指定したスキルリストから新しいコレクションを定義します |
collection save <name> | 現在有効なすべてのスキルをコレクションとして保存します |
collection show <name> | コレクション内のスキルを、現在の有効/無効ステータスとともに一覧表示します |
collection on <name> | コレクション内のすべてのスキルを有効にします |
collection off <name> | コレクション内のすべてのスキルを無効にします |
collection delete <name> | コレクション定義を削除します |
collection add <name> <skills...> | 既存のコレクションにスキルを追加します |
collection remove <name> <skills...> | コレクションからスキルを削除します |
仕組み
個人スキル:~/.claude/skills/<name>/(有効)と ~/.claude/skills/disabled/<name>/(無効)の間で移動します。disabled/INDEX.md は、各操作の後に自動で再生成されます。
プラグインスキル:~/.claude/settings.json の enabledPlugins オブジェクトを切り替えます。プラグイン名(compound-engineering)と名前空間付きスキル名(compound-engineering:deepen-plan)の両方を指定できます。どちらの場合もスキルのサフィックスは取り除かれ、プラグイン全体が切り替わります。
コレクション:~/.claude/skills/skill-toggle/collections/ に JSON として保存される、名前付きのスキルグループです。各コレクションには、まとめて切り替えられる個人スキルやプラグインが登録されています。collection on research は research コレクション内のすべてを有効にし、collection off research はそれらを無効にします。コレクションは追加方式です。オンにしても、そのコレクション内のスキルだけが有効になり、コレクション外のスキルは無効になりません。現在有効なスキルのセットを保存するには、collection save を使用します。
例
# Disable two personal skills
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py disable smolvlm llama-cpp
# Enable a previously disabled skill
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py enable webflow-migrate
# Disable a plugin (all its skills go with it)
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py disable agent-evaluation
# List only what's currently disabled
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py list --disabled
# Clean orphan dirs and zip files
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py clean
# Create a named collection of skills
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py collection create research academic-research ancient-near-east-research rlama exa-search linear-a-decipherment
# Snapshot all currently-enabled skills as a collection
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py collection save baseline
# Disable all skills in a collection at once
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py collection off research
# Re-enable a collection
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py collection on research
# Show what's in a collection with current status
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py collection show research