跳到主要内容
AI教程

使用 Skill Cabinet 整理和检查本地 Agent Skills

运行 Skill Cabinet,浏览、检查并安全管理本地 Agent Skills,同时掌握快捷键、配置、主题与开发流程。

Skill Cabinet 本地 Agent Skills 管理界面

什么是 Skill Cabinet?

Skill Cabinet 是一个本地目录工具,用于管理安装在计算机上的 Agent Skills。它会扫描用户级目录,例如 .agents.claude.codex.cursor,其中也包括 Cursor 插件。它还会检查其他匹配的 ~/.* /skills 文件夹。

该应用会在基于浏览器的界面中展示发现的 Skills。你可以搜索目录、检查每个 Skill 的内容和 YAML frontmatter、打开其文件夹中的其他文件,以及从磁盘中移除不需要的 Skills。

Skill Cabinet 仅绑定到 127.0.0.1,因此其服务器只能通过本地计算机访问,而不会暴露在公共网络接口上。

主要功能

  • 自动发现:扫描受支持的用户级 Agent 工具目录和 Skills 文件夹。
  • 筛选:按目录缩小 Skill 列表范围。
  • 搜索:查找名称、描述、路径或 frontmatter 匹配的内容。
  • Skill 检查:以渲染形式或源代码形式显示 Skill 正文。
  • 元数据访问:显示与 Skill 关联的 YAML frontmatter。
  • 文件夹浏览:读取与 Skill 存储在一起的其他文件。
  • Skill 移除:删除单个 Skill,或一次删除多个已标记的 Skills。
  • 主题:可通过 Theme 菜单选择皮肤,默认主题为 Carbon。
  • 键盘导航:支持用于移动、搜索、标记和删除的快捷键。

系统要求

Skill Cabinet 要求使用 Node.js 20 或更高版本。开始之前,请确认已安装的 Node.js 版本:

node --version

如果显示的主版本号低于 20,请升级 Node.js,然后再次运行该命令。

运行 Skill Cabinet

启动 npm 软件包

使用 npx 是启动该应用最快捷的方式:

npx skill-cabinet

此命令会在 127.0.0.1 上启动本地服务器,默认使用端口 3781,并在浏览器中打开界面。

直接从 GitHub 仓库运行

你也可以运行仓库版本,而不是 npm 软件包:

npx github:subsy/skill-cabinet

阻止自动打开浏览器

如果希望启动服务器时不替换或打开浏览器标签页,请设置 SKILL_CABINET_NO_OPEN

SKILL_CABINET_NO_OPEN=1 npx skill-cabinet

启动后,在准备就绪时打开应用显示的本地地址。

选择其他端口

设置 PORT 环境变量,即可使用 3781 以外的端口:

PORT=4000 npx skill-cabinet

在此示例中,Skill Cabinet 运行于 127.0.0.1:4000

浏览和搜索 Skills

  1. 使用 npx skill-cabinet 启动 Skill Cabinet。
  2. 等待本地界面在浏览器中打开。
  3. 使用目录筛选器,仅查看来自特定受支持位置的 Skills。
  4. 使用搜索功能匹配 Skill 的名称、描述、路径或 frontmatter。
  5. 选择一项结果以检查其内容。

如果你只记得描述的一部分、某个目录路径,或存储在 YAML 元数据中的某个值,搜索功能会非常实用。

检查 Skill

选择一个 Skill 后,可以通过渲染形式或源代码形式阅读其正文。渲染视图便于阅读,而源代码视图适合检查底层文本。

你还可以检查 Skill 的 YAML frontmatter,并读取其目录中包含的其他文件。结合这些视图,你可以在进行更改之前了解 Skill 包含哪些内容以及安装在何处。

谨慎删除 Skills

Skill Cabinet 可以删除单个 Skill,也可以一次删除多个已标记的 Skills。删除操作会从磁盘中移除完整的 Skill 目录。

警告:删除操作无法撤销。删除前,请仔细检查所选 Skills 及其路径。

Cursor 内置 Skills 和存储在插件缓存中的副本,可能会在相关工具下次更新时重新出现。因此,删除这些副本可能并非永久有效。

使用键盘快捷键

使用键盘命令可以更快地处理大型 Skill 目录:

  • j 移至下一项。
  • k 移至上一项。
  • / 激活搜索。
  • x 标记一项。
  • d 删除选中或已标记的 Skill 条目。

一种实用的工作流程是:按 / 进行搜索,使用 jk 浏览结果,使用 x 标记相关条目,并在确认每个路径后再执行删除。

更改界面主题

打开 Theme 菜单即可在可用皮肤之间切换。默认选中 Carbon。更改主题只会影响界面外观,不会改变已发现的 Skills 或其文件。

在本地开发 Skill Cabinet

如需处理源代码,请克隆仓库并安装其依赖项:

git clone git@github.com:subsy/skill-cabinet.git
cd skill-cabinet
npm install
npm run dev

然后在浏览器中打开 http://127.0.0.1:5173

运行生产构建

使用以下命令构建应用并以生产模式启动:

npm run build
npm start

仓库贡献者应查阅 CONTRIBUTING.md,了解该项目的贡献指南。

高级技巧

  • 删除前先检查:检查路径、源代码、frontmatter 和其他文件,确保选中了目标目录。
  • 结合使用筛选和搜索:先选择一个目录,再按名称、描述、路径或元数据在缩小后的列表中搜索。
  • 使用标记进行批量清理:使用 x 标记多个条目,但在按下 d 前应核对完整列表。
  • 保留当前浏览器状态:如果不希望应用在启动时自动打开界面,请使用 SKILL_CABINET_NO_OPEN=1
  • 避免端口冲突:如果端口 3781 已被占用,请使用不同的 PORT 值启动应用。
  • 预期托管的 Skills 会重新出现:Cursor 内置 Skills 和插件缓存副本可能会被后续工具更新恢复。

总结

Skill Cabinet 提供了一个专注的本地界面,用于发现和检查分散在多个工具目录中的 Agent Skills。借助可搜索的元数据、源代码与渲染视图、文件夹检查、主题、键盘控制和批量删除功能,它可以简化本地 Skill 管理。由于删除操作无法撤销,请在移除每个 Skill 前使用检查工具进行确认。

Skill Cabinet 采用 MIT License 发布。