OpenSkills

OpenSkills 是 Anthropic的 Claude Skills 系统的开源实现。它让 Cursor、Windsurf、Aider 等主流 AI 编码代理也能使用与 Claude Code 完全兼容的技能系统——相同的提示格式、相同的文件结构、相同的渐进式披露机制，只是调用方式从内置工具变为 CLI 命令。

一句话定位：
最接近 Claude Code 技能系统的开源方案，唯一区别：Skill("name") → openskills read name

✅ 为什么需要 OpenSkills？

Claude Code 的技能系统强大但封闭：

• 仅限 Anthropic 官方市场（anthropics/skills）
• 无法与非 Claude 代理共享
• 难以版本控制或扩展自定义技能

OpenSkills 解决了三大痛点：

核心特性：100% 兼容 Claude Skills

OpenSkills 在以下方面完全复刻 Anthropic 规范：

• 提示格式：生成 <available_skills> XML，嵌入 AGENTS.md
• 文件结构：默认使用 .claude/skills/<name>/SKILL.md
• 技能内容：YAML 前言 + Markdown 指令（支持 references/, scripts/, assets/）
• 加载机制：渐进式披露（仅在调用时加载详细说明，避免污染上下文）
• 市场来源：直接克隆 github.com/anthropics/skills

唯一差异：

• Claude Code：调用 Skill("pdf")（内置工具）
• OpenSkills：调用 Bash("openskills read pdf")（CLI 命令）

这一设计确保任何支持 Bash 执行的代理都能无缝使用。

快速开始

# 1. 全局安装
npm i -g openskills

# 2. 安装官方技能（交互式选择）
openskills install anthropics/skills

# 3. 同步到 AGENTS.md（需已存在该文件）
openskills sync

完成后，你的 AGENTS.md 将包含如下结构：

<skills_system priority="1">
<usage>
当用户要求您执行任务时，检查以下可用技能...
调用：Bash("openskills read <技能名称>")
</usage>

<available_skills>
<skill>
<name>pdf</name>
<description>用于提取文本和表格、创建新 PDF...</description>
<location>project</location>
</skill>
<!-- 其他技能 -->
</available_skills>
</skills_system>

代理在任务中扫描到 <available_skills> 后，会自动调用对应 CLI 命令加载技能说明。

📁 技能目录结构（完全兼容）

.claude/skills/
└── pdf/
    ├── SKILL.md          # 核心说明（YAML + Markdown）
    ├── references/       # API 文档、规范
    ├── scripts/          # 辅助脚本（如 extract_text.py）
    └── assets/           # 模板、配置文件

SKILL.md 示例：

---
name: pdf
description: 综合 PDF 操作工具包
---

# PDF 技能说明

当用户要求处理 PDF 时：
1. 安装依赖：`pip install pypdf2`
2. 使用 scripts/extract_text.py 提取内容
3. 捆绑资源路径见技能加载输出

高级用法：多代理通用模式

若你同时使用 Claude Code + Cursor/Windsurf，为避免技能重复，可启用 --universal 模式：

openskills install anthropics/skills --universal
# → 安装到 .agent/skills/ 而非 .claude/skills/

优势：

• 所有代理通过 AGENTS.md 共享同一技能集
• 不与 Claude Code 内置市场冲突
• 清晰分离：.claude/ 仅用于官方插件，.agent/ 用于自定义/共享技能

技能加载优先级：

1. ./.agent/skills/（项目通用）
2. ~/.agent/skills/（全局通用）
3. ./.claude/skills/（项目）
4. ~/.claude/skills/（全局）

命令行工具

所有命令默认提供美观 TUI 界面（复选框选择、描述预览），也支持 -y 参数用于 CI/脚本。

为什么用 CLI 而非 MCP？

MCP（Model Context Protocol）适用于动态服务（数据库、API），而 Skills 是静态工作流：

OpenSkills 选择 CLI 方案，忠于 Anthropic 的原始设计（SKILL.md 是文件，不是服务），同时最大化通用性。

系统要求

• Node.js 20.6+（依赖 ora 等库）
• Git（用于克隆仓库）