面向 AI 编码代理的通用技能加载器

一个 CLI。所有代理。与 Claude Code 相同的格式。

快速入门 · 工作原理 · 命令 · 创建技能 · 常见问题

✨ OpenSkills 是什么？

OpenSkills 将 Anthropic 的技能系统 带给所有 AI 编码代理——Claude Code、Cursor、Windsurf、Aider、Codex，以及任何能够读取 AGENTS.md 的工具。

可以把它看作 SKILL.md 的通用安装程序。

🚀 快速入门

npx openskills install anthropics/skills
npx openskills sync

默认情况下，安装是项目本地的（./.claude/skills，或使用 --universal 时为 ./.agent/skills）。若需全局安装至 ~/.claude/skills，请使用 --global。

✅ 为什么选择 OpenSkills？

• 与 Claude Code 完全兼容——相同的提示格式、相同的市场、相同的文件结构
• 通用性——适用于 Claude Code、Cursor、Windsurf、Aider、Codex 等多种工具
• 渐进式披露——仅在需要时加载技能，保持上下文简洁
• 适合版本控制——技能存储在项目中，可进行版本管理
• 支持私有仓库——可从本地路径或私有 Git 仓库安装技能

🧠 工作原理

Claude Code 系统提示（技能）

Claude Code 以 SKILL.md 文件 的形式分发技能，并将其暴露在 <available_skills> 块中。当用户请求任务时，Claude 会动态加载匹配的技能。

<available_skills>
<skill>
<name>pdf</name>
<description>全面的 PDF 操作工具包，用于提取文本和表格……</description>
<location>plugin</location>
</skill>
</available_skills>

OpenSkills：相同格式，通用加载器

OpenSkills 在你的 AGENTS.md 中生成 完全相同的 <available_skills> XML，并通过以下命令加载技能：

npx openskills read <skill-name>

因此，任何能够读取 AGENTS.md 的代理都可以使用 Claude Code 的技能，而无需依赖 Claude Code 本身。

对比表

<skills_system priority="1">

## 可用技能

<!-- SKILLS_TABLE_START -->
<usage>
当用户请求执行任务时，请检查下方列出的可用技能是否能更高效地完成该任务。

使用方法：
- 调用：`npx openskills read <skill-name>`（在终端运行）
- 技能内容将加载，并附带详细说明
- 输出中会提供基础目录，用于解析打包资源

使用注意事项：
- 仅使用下方 <available_skills> 中列出的技能
- 不要重复加载已在上下文中存在的技能
</usage>

<available_skills>

<skill>
<name>pdf</name>
<description>全面的 PDF 操作工具包，用于提取文本和表格、创建新 PDF、合并/拆分文档以及处理表单……</description>
<location>project</location>
</skill>

</available_skills>
<!-- SKILLS_TABLE_END -->

</skills_system>

🔧 安装技能

来自 Anthropic 市场

npx openskills install anthropics/skills

来自任意 GitHub 仓库

npx openskills install your-org/your-skills

来自本地路径

npx openskills install ./local-skills/my-skill

来自私有 Git 仓库

npx openskills install git@github.com:your-org/private-skills.git

🌍 通用模式（多代理环境）

如果你同时使用 Claude Code 和其他代理，并共用一个 AGENTS.md，则应将技能安装到 .agent/skills/ 目录下，以避免与 Claude 的插件市场发生冲突：

npx openskills install anthropics/skills --universal

优先级顺序（最高者胜出）：

1. ./.agent/skills/
2. ~/.agent/skills/
3. ./.claude/skills/
4. ~/.claude/skills/

🧰 命令

npx openskills install <source> [options]  # 从 GitHub、本地路径或私有仓库安装
npx openskills sync [-y] [-o <path>]       # 更新 AGENTS.md（或自定义输出）
npx openskills list                        # 显示已安装的技能
npx openskills read <name>                 # 加载指定技能（供代理使用）
npx openskills update [name...]            # 更新已安装的技能（默认更新全部）
npx openskills manage                      # 交互式移除技能
npx openskills remove <name>               # 移除特定技能

标志位

• --global — 全局安装至 ~/.claude/skills（默认为项目安装）
• --universal — 安装至 .agent/skills/ 而不是 .claude/skills/
• -y, --yes — 跳过提示（适用于 CI）
• -o, --output <path> — 同步时的输出文件（默认为 AGENTS.md）

🧬 SKILL.md 格式

OpenSkills 使用 Anthropic 的精确格式：

---
name: pdf
description: 全面的 PDF 操作工具包，用于提取文本和表格、创建新 PDF、合并/拆分文档以及处理表单。
---

# PDF 技能使用说明

当用户请求处理 PDF 时，请按照以下步骤操作：
1. 安装依赖：`pip install pypdf2`
2. 使用 scripts/extract_text.py 提取文本
3. 参考 references/api-docs.md 获取详细信息

技能是 按需加载 的，从而保持代理的上下文简洁且专注。

🧪 创建你自己的技能

最小化结构

my-skill/
└── SKILL.md

包含资源

my-skill/
├── SKILL.md
├── references/
├── scripts/
└── assets/

安装你自己的技能：

npx openskills install ./my-skill

使用符号链接进行本地开发

git clone git@github.com:your-org/my-skills.git ~/dev/my-skills
mkdir -p .claude/skills
ln -s ~/dev/my-skills/my-skill .claude/skills/my-skill

作者指南

npx openskills install anthropics/skills
npx openskills read skill-creator

🔄 更新技能

如果你是从 Git 仓库安装的技能，可以随时刷新：

npx openskills update

若需更新特定技能，可传入逗号分隔的列表：

npx openskills update git-workflow,check-branch-first

如果某项技能是在未跟踪更新之前安装的，需重新安装一次以记录其来源。

✅ 提示

• 你始终可以通过 npx 运行 OpenSkills；全局安装是可选的。
• 如果需要读取多个技能，建议使用逗号分隔的名称：npx openskills read foo,bar。

❓ 常见问题解答

为什么选择 CLI 而不是 MCP？

MCP 适用于动态工具。 技能则是静态的指令加资源。

• 技能只是文件，无需服务器支持。
• 可与任何智能体配合使用，无需 MCP 支持。
• 符合 Anthropic 的设计——SKILL.md 就是规范。

MCP 和技能解决的是不同问题。OpenSkills 让技能保持轻量级和通用性。

📋 系统要求

• Node.js 20.6 或更高版本
• Git（用于克隆仓库）

📜 许可证

Apache 2.0

致谢

实现了 Anthropic 的 Agent Skills 规范。

与 Anthropic 无关联。 Claude、Claude Code 和 Agent Skills 是 Anthropic, PBC 的商标。

OpenSkills 快速上手指南

OpenSkills 是一个通用的 AI 编码代理技能加载器。它将 Anthropic 的 Skills 系统（SKILL.md）带给所有支持读取 AGENTS.md 的 AI 工具（如 Claude Code、Cursor、Windsurf、Aider 等），实现“一次安装，处处可用”。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本 20.6 或更高。
• Git: 已安装并配置好，用于克隆技能仓库。
• 终端: 支持运行 npx 命令的命令行工具。

提示：国内用户若遇到 npm 包下载缓慢的问题，可临时配置淘宝镜像源： npm config set registry https://registry.npmmirror.com

安装步骤

OpenSkills 无需全局安装，推荐直接使用 npx 运行，也可按需全局安装。

方式一：直接使用 (推荐)

无需预先安装，直接在项目目录运行命令即可自动拉取最新执行文件。

方式二：全局安装 (可选)

如果您希望将 openskills 作为全局命令使用：

npm install -g openskills

基本使用

以下是将官方技能库集成到您的项目并同步配置的最简流程。

1. 安装技能库

从 Anthropic 官方技能市场安装技能到当前项目（默认保存在 ./.claude/skills）：

npx openskills install anthropics/skills

多代理兼容模式：如果您同时使用 Claude Code 和其他代理工具，建议使用 --universal 参数，将技能安装至 ./.agent/skills 以避免冲突：

npx openskills install anthropics/skills --universal

2. 同步配置

运行 sync 命令，自动在项目根目录生成或更新 AGENTS.md 文件，注入技能定义信息：

npx openskills sync

3. 验证与使用

安装完成后，您的 AI 代理（如 Cursor 或 Windsurf）在读取 AGENTS.md 时即可识别可用技能。

您可以在终端手动测试加载某个技能（例如 pdf 技能）：

npx openskills read pdf

此时，AI 代理将根据 AGENTS.md 中的指引，在需要时动态调用该技能，保持上下文整洁高效。