关于 skill-toggle
skill-toggle 是用于统一管理个人技能和插件技能的命令行工具,面向整理 Claude 技能的用户。它还支持状态查询、搜索、清理和按集合批量切换。
主要功能
- 01启用或停用个人技能
- 02在 settings.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
详细介绍
Skill Toggle
通过一个 CLI 管理个人技能和插件技能。
用法
python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py <command> [args]
命令
| 命令 | 操作 |
|---|---|
list | 显示所有技能及其状态(已启用/已禁用)、来源和描述 |
list --enabled | 仅显示已启用的技能 |
list --disabled | 仅显示已禁用的技能 |
list --plugins | 仅显示插件技能 |
disable <name> [name...] | 禁用一个或多个技能(个人技能:移至 disabled/;插件技能:切换 settings.json) |
enable <name> [name...] | 启用一个或多个技能(与 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)——无论哪种形式,都会去掉技能后缀并切换整个插件。
集合:以 JSON 格式存储在 ~/.claude/skills/skill-toggle/collections/ 中的技能命名组。每个集合列出可作为一个整体切换的个人技能和/或插件。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
评论
支持 Markdown