skillsvault

---

⚡ 添加到你的 Agent

npx skills add skillsvault/skillsvault-skill

就这么简单。你的 Agent 会读取技能并自行完成初始化 — 它会安装 skillsvault CLI，提示你登录一次，然后将组织批准的技能拉取到这台机器上的每个运行框架中：

curl -fsSL https://skillsvault.io/install.sh | sh
skillsvault login
skillsvault pull --all

作为 Claude Code 插件

claude plugin marketplace add skillsvault/skillsvault-skill
claude plugin install skillsvault@skillsvault

Claude 首次使用时，运行 /mcp 并登录 skillsvault：选择你的组织即可，无需粘贴密钥或将密钥存入文件。该插件会添加：

• skillsvault 技能：与上方相同的技能。
• skillsvault MCP 服务：list_skills、load_skill 和 get_skill_file 让 Claude 读取组织批准的技能。这三项均为只读。若技能被组织策略禁止，系统会拒绝访问并说明原因。
• 门禁钩子：Claude 运行技能、子 Agent 或输入的 /command 之前，会先询问 skillsvault CLI 组织是否允许。若被阻止，会显示策略给出的原因和申请例外的链接。只有安装 CLI 后钩子才会生效；如果 skillsvault install-hook 已配置门禁，钩子便不会介入。

用于其他 Agent

同一代码库也可作为其他 Agent 的插件。每个 Agent 首次连接时都会引导你登录 skillsvault：

• **Cursor、Codex 和 ChatGPT：**添加 MCP 服务 https://skillsvault.io/api/mcp。市场列表即将推出；该插件已遵循 Agent Plugins 标准（plugin.json、mcp.json、skills/）。
• Gemini CLI：gemini extensions install https://github.com/skillsvault/skillsvault-skill
• **其他支持 MCP 的工具：**添加 https://skillsvault.io/api/mcp。它已在官方 MCP Registry 中登记，名称为 io.skillsvault/skillsvault。

发送哪些内容，以及发送到哪里

• **MCP 服务。**登录后，它会以你的身份调用 https://skillsvault.io/api/mcp。它会发送 Claude 请求的技能名称，并接收组织的技能内容。每次加载都会记录在组织的审计日志中。
• **门禁钩子。**它会在你的机器上使用组织策略的签名副本运行，每次判定都无需网络调用。CLI 会将每次判定（技能名称和版本、判定结果、原因、机器名称）报告到组织的审计日志中。它还会定期发送心跳（CLI 版本、门禁钩子是否已配置，以及机器上安装的技能名称），让组织了解哪些机器已受保护。
• **除此之外，不发送任何内容。**除 skillsvault.io 外，不会向任何地方发送数据。你的提示词和代码绝不会被发送。请参阅隐私政策。

🎬 查看运行效果

## 🧭 为什么

Agent 会从各种地方获取技能——代码仓库、市场、队友和其他 Agent。没人知道每个地方运行的是哪个版本，而有毒或过时的技能看起来和好技能一模一样。skillsvault 为你的组织提供唯一可信来源：

📦 有版本管理的注册表	每项技能都按内容寻址、带版本号并经过签名。pull 会安装获批版本，并移除被禁用的版本。
🚦 管控关卡	每次调用都会在本地运行前接受检查：允许 / 警告 / 阻止。使用缓存的策略包即可离线运行。
🧾 审计跟踪	记录谁在什么主机上、依据什么策略运行了哪个版本的技能；记录只能追加，并且可导出。
🕸️ 适用于所有执行环境	为 Claude Code、Codex、Pi 以及其他任何运行技能的工具提供统一策略。

🛠️ Agent 如何使用它

连接后，这项技能会教会 Agent 自我治理：

skillsvault whoami                    # which org am I connected to?
skillsvault install-hook              # gate every skill invocation (Claude Code)
skillsvault pull --all                # install approved skills, remove banned ones
skillsvault gate --skill <org/skill>  # allow / warn / halt — before use
skillsvault publish <path>            # push a skill to the org registry
skillsvault status                    # how fresh is the policy bundle?

这项技能始终强制执行三条规则：

1. 如果管控关卡阻止某项技能 → Agent 就不会运行它。永远不会。
2. pull 获取的获批版本优先于任何旁加载副本。
3. 绝不绕过阻止结果——判定会指出获批的替代版本。

📚 了解更多

• 📖 文档 — CLI 参考、策略和签名包约定
• 🚀 快速入门 — 五分钟内从零开始实现治理
• 🔍 SKILL.md — 技能本身，也就是 Agent 实际读取的内容
• 🧾 references/cli.md — 完整命令参考

许可证

Apache-2.0 — 详见 LICENSE。此许可证适用于本仓库中的技能和插件；skillsvault 服务受其条款约束。