OpenSkills —— 通用技能加载器
一个 CLI,适配所有 AI 编程代理,统一加载 Anthropic 风格的 SKILL.md 技能。
证据显示:CLI 工具,默认项目本地安装,支持 --global 和 --universal 选项;有 -y 跳过提示;SECURITY.md 提到使用 HTTPS git clone,清理临时目录,默认只从公共仓库安装;依赖极少(commander 等),无遥测;有路径穿越安全测试;有更新和移除命令。扣分原因:权限最小化方面,工具会修改 AGENTS.md 和安装技能文件,但未明确说明所需权限范围;用户确认方面,有 -y 跳过提示,但未说明默认是否提示;数据流透明度方面,未说明技能内容如何被加载和使用;敏感数据处理方面,未说明如何处理技能中的敏感数据;依赖安全方面,依赖版本使用 ^ 范围,未锁定;外部影响方面,会修改文件系统,但未说明具体影响;回滚方面,有 remove 命令,但未说明是否支持回滚到之前状态;来源归属方面,未说明如何验证技能来源。
证据显示:README 和 SECURITY.md 描述一致,测试覆盖了路径检测、路径穿越、同步逻辑等;依赖在 package.json 中声明,有 CI 测试;但失败消息方面,未提供错误处理示例或用户提示。扣分原因:自洽性方面,文档和测试基本一致,但未深入验证;依赖可用性方面,依赖声明完整,但未验证实际可用性;失败消息方面,未提供错误处理示例或用户提示。
证据显示:README 明确目标用户为 AI 编码代理用户,支持多种代理(Claude Code, Cursor 等);能力边界明确,只处理 SKILL.md 格式;触发精度方面,通过命令和 XML 标记精确控制;环境适配方面,支持 Node.js 20.6+,跨平台。扣分原因:受众和场景方面,描述清晰但未提供具体使用案例;能力边界方面,明确但未深入讨论限制;触发精度方面,命令和 XML 标记明确,但未讨论误触发风险;环境适配方面,支持 Node.js 20.6+,但未讨论其他环境限制。
证据显示:README 结构清晰,有快速开始、命令、FAQ 等;安装说明详细,支持多种安装方式;命名稳定,命令和选项命名一致;有示例和 FAQ;已知限制方面,SECURITY.md 提到一些安全注意事项,但未明确列出功能限制;许可证为 Apache 2.0;版本号在 package.json 中,但无 CHANGELOG;维护责任方面,未明确说明维护者或贡献指南。扣分原因:信息架构良好,但缺少详细文档;安装说明详细,但未提供故障排除;命名稳定,但未说明版本兼容性;示例和 FAQ 有,但未覆盖所有场景;已知限制方面,未明确列出功能限制;许可证明确,但未提供许可证全文;版本化变更日志缺失;维护责任未明确。
证据显示:输出为 AGENTS.md 中的 XML 和技能文件,可直接被代理使用;边际价值方面,提供了跨代理的技能加载功能,有独特价值;成本效益方面,依赖少,安装简单。扣分原因:输出可用性方面,输出格式明确,但未验证实际效果;边际价值方面,有独特功能,但未与其他工具对比;成本效益方面,依赖少,但未评估维护成本。
证据显示:README 声称实现 Anthropic 的 Agent Skills 规范,但未提供具体链接或验证;测试覆盖了部分功能,但未独立验证;事实和推断分离方面,文档中区分了事实和推断,但未明确标注。扣分原因:声明可追溯性方面,未提供具体来源链接;跨来源佐证方面,未提供第三方验证;事实推断分离方面,未明确区分。
- 该工具会修改 AGENTS.md 和安装技能文件,请确保在可信环境中使用。
- 技能内容可能包含可执行脚本,加载前请审查。
- 依赖版本使用 ^ 范围,建议锁定版本以确保可重复构建。
- 发布者身份未验证,请谨慎评估来源可信度。
这个 Agent 能做什么,适合哪些场景?
OpenSkills 是一个通用技能加载器,可以将 Anthropic 的技能系统(SKILL.md 文件)带到 Claude Code、Cursor、Windsurf、Aider、Codex 等任何能读取 AGENTS.md 的 AI 编程代理。它生成与 Claude Code 完全相同的 <available_skills> XML 块,写入 AGENTS.md,并通过 `npx openskills read <skill-name>` 按需加载技能。安装来源包括 Anthropic 官方技能市场、任意 GitHub 仓库、本地路径或私有 Git 仓库。支持项目级(.claude/skills 或 .agent/skills)和全局(~/.claude/skills)安装,并提供 install、sync、list、read、update、manage、remove 等命令。OpenSkills 基于 Apache 2.0 许可,需要 Node.js 20.6+ 和 Git。
OpenSkills 提供 CLI 工具(npx openskills)。install 命令从 GitHub 仓库(如 anthropics/skills)、本地路径或私有 Git 仓库克隆技能到指定目录(默认 ./.claude/skills,或通过 --universal 使用 ./.agent/skills,--global 使用 ~/.claude/skills)。sync 命令生成或更新 AGENTS.md,在其中写入 <available_skills> XML 块,列出已安装技能。read 命令按名称输出技能内容(SKILL.md 的完整内容),供代理读取。list 显示已安装技能,update 从来源拉取更新,remove 删除技能。所有命令通过 Node.js 和 Git 在 shell 中执行,需要网络访问以克隆仓库。
- 使用 Claude Code 的开发者在项目中安装 Anthropic 官方技能包(anthropics/skills),以快速获得 PDF 处理等技能。
- 同时使用 Claude Code 和其他代理(如 Cursor、Windsurf)的团队,通过 --universal 安装到 .agent/skills 来避免冲突。
- 希望将技能纳入版本控制并在团队中共享的开发者,通过本地路径或 Git 仓库安装自定义技能。
- 需要从私有 Git 仓库安装技能的开发者,使用 SSH 安装方式。
- 希望控制上下文长度、按需加载技能的代理用户,通过 read 命令动态加载技能。
- CI 环境中自动化安装和同步技能,使用 -y 标志跳过确认。
这个 Agent 有哪些优点和局限?
- 与 Claude Code 完全兼容:生成相同的 <available_skills> XML 和文件夹结构 (.claude/skills),可直接使用 Anthropic 官方技能市场。
- 通用性:适用于任何能读取 AGENTS.md 的代理(Claude Code、Cursor、Windsurf、Aider、Codex),无 MCP 依赖。
- 渐进式披露:技能按需加载,保持上下文干净。
- 支持私有和本地安装:可从本地路径、私有 Git 仓库安装技能。
- 技能文件可版本化:技能存放在项目内,便于团队共享。
- 需要 Node.js 20.6+ 和 Git,可能不适用于所有环境。
- 技能加载依赖 npx,代理需要能执行 shell 命令。
- 目前技能来源主要依赖 Anthropic 官方市场或 GitHub,可能需要网络分支。
- license 字段为 NOASSERTION,尽管 README 声明 Apache 2.0,但没有明确许可证文件。
- 对于非 Claude 代理,技能格式可能不完全兼容,需要调整。
如何安装或部署这个 Agent?
OpenSkills 通过 npx 运行,无需全局安装。确保 Node.js 20.6+ 和 Git 已安装。运行 npx openskills install anthropics/skills 从 Anthropic 市场安装技能,或 npx openskills install <source> 从其他来源安装。默认安装到项目本地 ./.claude/skills 目录。
如何使用这个 Agent?
安装技能后,运行 npx openskills sync 生成或更新 AGENTS.md,其中包含 <available_skills> 块。代理可通过 npx openskills read <skill-name> 读取技能内容。也可使用 npx openskills list 查看已安装技能,npx openskills update 更新技能,npx openskills remove <name> 删除技能。
这个 Agent 与同类方案有什么区别?
与 Claude Code 内置的技能系统相比,OpenSkills 提供了相同的格式和技能存储,但引入了更广泛的代理支持,并通过 AGENTS.md 实现跨代理兼容。与 MCP 相比,OpenSkills 更轻量,无需服务器。
常见问题
OpenSkills 是否需要 MCP 服务器?
如何从私有 Git 仓库安装技能?
npx openskills install [email protected]:your-org/private-skills.git,需要配置好 SSH 密钥。OpenSkills 是否与 Claude Code 的技能市场兼容?
是否可以全局安装技能?
--global 标志安装到 ~/.claude/skills,适用于多个项目。