安装和管理技能

本指南介绍如何用 GitHub 上的技能填充工作区：把一个仓库添加为来源，从中安装你需要的技能，并让它们长期保持最新。

动手之前必须先了解一件事：来源仓库是不可信的。 它的名称、描述和 star 数都由持有它的那个人填写。Control Center 唯一信任的安全信号是杀毒扫描结论，任何内容在写入磁盘或进入智能体提示词之前，每次安装都要先通过这道检查。如果你想知道背后的理由，请阅读智能体模型中的技能部分；本页只讲怎么做。

技能位于 设置 → 工作区 → 技能 （/workspaces/<id>/settings/workspace/skills）。它们的作用域是工作区：你在这里安装的技能只属于这个工作区。该页面有两个标签页：已安装（本地技能，其中包括一个 新建技能编辑器）和来源（GitHub 技能目录）。两种写入都要通过同一道扫描关卡。

添加技能仓库

打开 设置 → 工作区 → 技能，切换到来源标签页。
按下添加仓库。
粘贴一个 GitHub 仓库 URL，例如 https://github.com/anthropics/skills，然后确认。

服务器会用自身的凭据检查该仓库是否存在且可见，然后把它添加到左侧栏。中间没有经过筛选的商店：任何 GitHub 仓库都可以，这也意味着声誉要由你自己判断——star 数只是证据，从来不是保证。

一个仓库里的技能，就是那些包含 SKILL.md 的目录（最多三层深，另外还包括 Claude 插件市场布局 plugins/<plugin>/skills/<skill>，并跳过依赖目录和第三方目录）。如果网格稍后显示该仓库没有技能，意思就是如此：其中没有任何目录符合这套技能约定。

安装前检查技能

在左侧栏中选择一个仓库，它的技能会以网格形式出现在右侧，网格上方有一个筛选输入框，可按名称、描述或 slug 缩小目录范围。点击一张卡片即可打开详情视图。它会显示三项内容：

README，以 Markdown 渲染——即技能目录中的 README.md；若没有 README，则是 SKILL.md 的正文。
扫描预览——扫描结论（pass、warn 或 quarantine）、技能内容声明自身具备的能力（运行 shell、写入文件、网络访问……），以及扫描器记录下来的每一项发现。
文件数量——一次安装会写入技能的整个目录，而不只是它的 SKILL.md。

预览扫描的正是安装将要写入的那些字节，因此你看到的结论就是安装会得到的结论；不会在你背后重新判定。

安装技能

打开该技能的详情视图。
阅读扫描结论。如果结论是 warn 或 pass，按下安装。
如果结论是 quarantine，在你勾选我了解风险，仍要安装之前，安装会一直处于禁用状态。这次覆盖操作会被记录下来，而不是被默认假定。

安装会把技能的目录写入工作区，在 skills-lock.json 中记录一条锁定信息（来源仓库、路径、它所来自的提交以及内容哈希），该技能随后即可供工作区内的智能体使用。标有名称已被占用 的卡片表示本地已有另一个技能占用了这个名称——请先卸载那一个。

长期更新技能

已安装技能的卡片会带有徽章：已安装，或者当仓库已经越过你锁定的那个提交时显示 有可用更新。打开详情视图并按下更新，即可按新的提交重新获取。更新与安装要通过同一道扫描关卡——新版本被隔离的技能会被拒绝，你原有的版本保持不变。旧版本的哈希会作为回滚参照保留在锁定文件中。

卸载技能、移除仓库

卸载（位于已安装技能的详情视图上，或在已安装标签页中删除）会一并移除技能的目录和它的锁定记录——卸载后的技能不会留下任何残留。

从左侧栏中移除仓库只会移除那份技能目录：你从它安装的技能仍保持安装状态，也仍能更新，因为锁定记录是按名称记录仓库的，而不是引用来源条目。如果你想再次浏览它，把该仓库重新添加回来即可。

调用技能

技能在自己的命名空间下被调用，因此绝不会与内置斜杠命令（/plan、/goal、/loop、 /compact）冲突：

/skill:<name>——安装在此工作区中、或附加到该智能体上的技能
/skill:<repo>:<name>——本空间中检出的某个仓库所自带的技能

对于命名空间出现之前写下的消息，不带前缀的非内置名称仍能解析。要调用名为 plan 的技能，得写 /skill:plan；/plan 始终是内置命令。

仓库范围内的技能

一个已检出的仓库可以自带技能，位于 .agents/skills/、.agent/skills/、 .claude/skills/、.opencode/skills/ 或 skills/。这些技能不通过本页安装。智能体只携带它当前所在的那个仓库的技能；当它移动到别处时，这些技能随之切换。输入框不这样限定范围：/skill:<repo>:<name> 可以调用该空间中的任意仓库。

仓库技能在它们的 frontmatter 进入提示词之前，也要通过同一道失败即拒绝的扫描（pass / warn / quarantine）。warn 会被放行；quarantine 会被扣下，这条路径上没有任何操作员覆盖选项。

参见仓库范围内的技能和斜杠命令。