SuperAPI AI 工具集

skill-manager

智能体与模型

查看项目

更新于 10-30 12:15

技能介绍

用途 Skill Manager 用于在 macOS 上集中查看和开关 Claude Code 技能。它安装一个本地页面(由 Bun 在 127.0.0.1:4477 提供服务)和一个可从 Dock 或 Spotlight 打开的 Skill Manager.app,页面会列出 ~/.claude/skills 中的每个技能及其描述大小。

主要能力 每个开关都会把 skillOverrides 写入 ~/.claude/settings.json,新的 Claude Code 会话会读取该设置;当前会话不受影响。写入格式为 { "skillOverrides": { "<skill name>": "off" } }。状态含义如下:

  • 不存在(on):列出名称和描述,Claude 可自行选择。
  • name-only:只列出名称、不含描述,成本更低但被选中的可靠性下降。
  • user-invocable-only:对 Claude 隐藏,仅在用户输入 /name 时运行。
  • off:不加载。 这里的键是技能 SKILL.md frontmatter 中的 name,不一定是文件夹名。页面在把技能设回 on 时会删除对应键,保持文件干净。若 skillOverrides 不被识别,说明 Claude Code 版本过旧,需要更新;在交互式 claude 终端中,/skills 可切换同一设置。

使用方式 安装要求为 macOS 和 Bun。安装前需确认是否将应用固定到 Dock(固定会重启 Dock,图标会闪烁一次)。然后运行 sh <此技能文件夹>/scripts/install.sh,如同意固定则加 --dock。脚本会:把 assets/ 复制到 ~/.claude/skill-manager/;将 ~/.claude/settings.json 备份一次为 settings.json.bak-skill-manager;构建 /Applications/Skill Manager.app,若 /Applications 不可写则构建到 ~/Applications;停止正在运行的服务器,以便下次打开时提供新文件。 之后用 open "/Applications/Skill Manager.app" 打开应用;应用会在服务器未运行时启动服务器、等待其就绪,并在默认浏览器中打开页面。服务器会持续在后台运行,并在重启后首次打开时再次启动。

验证与告知 验证步骤包括:用 curl -s localhost:4477/api/skills | jq length 核对数量与含 SKILL.md 的技能文件夹数一致;切换一个技能为 off,检查 jq .skillOverrides ~/.claude/settings.json,再设回 on 并与备份比对,其他键须不变;冷启动测试(kill 服务器后打开应用确认 API 恢复);如有浏览器面板,检查浅色、深色和 375px 宽度下的页面。应向用户说明:应用所在位置(~/Applications 不在 Finder 常见的 /Applications 列表中);更改仅对新会话生效;off 只是对 Claude Code 隐藏,技能仍处于安装状态,用 skills CLI 安装的技能是指向 ~/.agents/skills 的符号链接,需用该 CLI 移除。相关文件位于 ~/.claude/skill-manager/(server.ts、index.html、open.sh、server.log)。

卸载 运行 lsof -t -iTCP:4477 -sTCP:LISTEN | xargs kill; rm -rf "/Applications/Skill Manager.app" ~/.claude/skill-manager,然后将图标从 Dock 拖走。skillOverrides 条目会保留,直到从 ~/.claude/settings.json 中移除。

限制 仅支持 macOS,且依赖 Bun。仅管理 Claude Code 技能,不负责卸载技能。收费、价格等信息暂未提供。