OpenSkills 通用技能加载器
一条命令、所有 AI 编程代理通用的 SKILL.md 安装器，让 Claude Code 技能生态在任何可读 AGENTS.md 的代理中即装即用。
该技能为纯文档示例，无脚本、无网络请求、无外部副作用，最少权限原则天然满足；仓库 SECURITY.md 有安全说明。扣分点：发布者身份未经验证，技能自身的源归属信息仅依赖仓库上下文，无独立确认。
指令内容自洽，引用的 references/skill-format.md 在仓库中确实存在，无执行路径故无运行时故障面；静态读取不上限10。扣分点：无针对该示例技能本身的测试或边界输入处理证据。
frontmatter 描述明确给出触发条件（学习技能创建、测试 loader），场景与受众清晰，纯 Markdown 无环境依赖。扣分点：作为示例技能无实际任务产出，未声明不适配范围，非功能定位使其真实触发精度有限。
文档分层良好（frontmatter、指令、references 递进披露），仓库提供 Apache 2.0 许可证、版本号与维护信号。扣分点：技能自身许可证元数据为 NOASSERTION，无 CHANGELOG，发布者与更新路径不明确。
作为格式示范与 loader 测试夹具可完成其声称目标，内容可直接使用。扣分点：价值为教学性而非任务性，相比直接阅读 Anthropic 规范文档边际价值有限，无产出验证证据。
内容与仓库内 references 文件相互一致，可审计一手材料；静态评审上限5。扣分点：无第三方执行证据，无独立复现或跨源佐证，仅文件间一致性。
- 该技能是教学示例，不产生实际任务结果，请勿将其当作生产力技能调用。
- 技能许可证元数据为 NOASSERTION，许可证信息仅存在于仓库层面，使用前请确认。
- 发布者未经注册表验证，安装任何技能前请自行审查内容（仓库 SECURITY.md 亦建议如此）。
- 加载示例中引用的脚本路径（scripts/helper.sh）在示例目录中并不存在，注意区分说明与实际文件。
这个 Skill 能做什么，适合哪些场景？
OpenSkills 是一个面向 AI 编程代理的通用技能加载器，通过 npm 提供 CLI（npm i -g openskills）。它把 Anthropic 的 SKILL.md 技能体系带到 Claude Code、Cursor、Windsurf、Aider、Codex 等任何能读 AGENTS.md 的代理上，生成与 Claude Code 完全一致的 <available_skills> XML。技能按需加载（渐进式披露），保持上下文干净，可从 GitHub、本地路径或私有 Git 仓库安装。仓库附带的示例技能 my-first-skill 演示了 SKILL.md 的标准格式与编写规范。注意：GitHub 许可证字段显示为 NOASSERTION，但 README 声明为 Apache 2.0，且明确表示与 Anthropic 无隶属关系。
安装技能：npx openskills install <source>，来源可以是 GitHub 仓库（如 anthropics/skills）、本地路径或私有 Git 仓库，默认装入项目内 ./.claude/skills（--universal 时装入 ./.agent/skills，--global 时装入 ~/.claude/skills）。同步清单：npx openskills sync 在 AGENTS.md 中写入 <available_skills> XML 块。读取技能：npx openskills read <skill-name> 由代理在 shell 中执行以加载完整指令，并输出基础目录用于解析 references/、scripts/、assets/ 等捆绑资源。另提供 list、update、remove、manage 等子命令管理已装技能。
- 使用 Cursor 或 Windsurf 的开发者，想直接复用 Anthropic 官方技能市场（anthropics/skills）中的技能而无需 Claude Code
- 多代理用户同时使用 Claude Code 与其他代理，需要用 --universal 模式装到 .agent/skills 避免目录冲突
- 团队希望把项目专属技能放进仓库做版本管理，通过本地路径或私有 Git 仓库安装
- 初次学习 Agent Skills 规范的开发者，可安装后用 npx openskills read skill-creator 阅读官方编写指南
- 希望按需加载指令以保持上下文窗口干净的重度代理用户
这个 Skill 有哪些优点和局限？
- 与 Claude Code 的提示格式、目录结构、技能市场完全兼容，迁移零成本
- 跨代理通用：任何能读 AGENTS.md 的代理（Cursor、Windsurf、Aider、Codex 等）都能使用
- 渐进式披露设计，技能按需加载，不污染上下文
- 支持本地路径、符号链接和私有 Git 仓库安装，对闭源/内网团队友好
- 技能以文件形式存在于项目中，可纳入版本控制
- GitHub 仓库许可证字段为 NOASSERTION，与 README 声明的 Apache 2.0 不一致，法律状态需自行确认
- 非 Anthropic 官方产品，且明确声明与 Anthropic 无隶属关系，上游规范变更可能造成滞后
- 技能加载依赖代理能在 shell 中执行命令，纯 API 调用场景需调用方自行提供执行环境
- README 未提供测试套件、下载量之外的成熟度证据，各代理端到端兼容性未见系统验证
- 源仓库 Topics 为空，可发现的元数据较少
如何安装这个 Skill？
需 Node.js 20.6+ 和 Git。推荐直接用 npx 无需全局安装：npx openskills install anthropics/skills && npx openskills sync。可选全局安装：npm i -g openskills。默认安装到项目内 ./.claude/skills；多代理场景加 --universal 装到 ./.agent/skills；加 --global 装到 ~/.claude/skills。
如何使用这个 Skill？
1) 安装技能：npx openskills install <github仓库/本地路径/私有git地址>。2) 运行 npx openskills sync 生成或更新 AGENTS.md 中的技能清单。3) 代理检测到任务匹配某技能时，在其 shell 中执行 npx openskills read <skill-name> 加载完整指令（多个技能可用逗号分隔：npx openskills read foo,bar）。4) 维护：npx openskills list 查看、npx openskills update 更新、npx openskills remove <name> 删除。
这个 Skill 与同类方案有什么区别？
README 自述与 Claude Code 原生技能系统对照：两者使用相同的 <available_skills> XML 提示格式和 .claude/skills/ 存储目录，但 Claude Code 用 Skill("name") 工具调用且仅限自身，OpenSkills 用 npx openskills read <name> 调用且跨代理通用；市场方面 Claude Code 用 Anthropic 官方市场，OpenSkills 直接从 GitHub 拉取。README 还辨析了与 MCP 的关系：MCP 面向动态工具（需服务器），技能是静态指令加资源（纯文件），二者解决不同问题而非竞争关系。