OpenSkills：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）。使用 --global 参数可安装至 ~/.claude/skills。

✅ 为什么选择 OpenSkills

与 Claude Code 完全兼容 —— 相同的提示词格式、相同的市场、相同的文件夹结构。
通用性 —— 适用于 Claude Code、Cursor、Windsurf、Aider、Codex 等。
渐进式披露 —— 仅在需要时加载技能（保持上下文简洁）。
对仓库友好 —— 技能驻留在项目内，可进行版本控制。
隐私友好 —— 支持从本地路径或私有 Git 仓库安装。

🧠 工作原理

Claude Code 系统提示词（技能）

Claude Code 将技能作为 SKILL.md 文件发布，并将其暴露在 <skills> 块中。当用户提出任务时，Claude 会动态加载匹配的技能。

<skills>
  <skill name="pdf">
    Comprehensive PDF manipulation toolkit for extracting text and tables...
  </skill>
</plugin>

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

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

npx openskills read <skill-name>

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

对比分析

特性	Claude Code	OpenSkills
提示词格式	`<skills>` XML	相同 XML
技能存储	`.claude/skills/`	`.claude/skills/` (默认)
调用方式	`Skill("name")` 工具	`npx openskills read <name>`
市场支持	Anthropic 市场	GitHub (anthropics/skills)
渐进式披露	✅	✅

OpenSkills 写入的 AGENTS.md 格式如下：

<skills>
## Available Skills

When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively.

How to use skills:
- Invoke: `npx openskills read <skill-name>` (run in your shell)
- The skill content will load with detailed instructions
- Base directory provided in output for resolving bundled resources

Usage notes:
- Only use skills listed in <skills> below
- Do not invoke a skill that is already loaded in your context

<skill name="pdf">
Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms...
</skill>
</skills>

🔧 安装技能

从 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

优先级顺序（优先级从高到低）：

./.agent/skills/
~/.agent/skills/
./.claude/skills/
~/.claude/skills/

🧰 命令

npx openskills install <source> [options]  # 从 GitHub、本地路径或私有仓库安装
npx openskills sync [-y] [-o <file>]       # 更新 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 <file> —— 同步输出文件 (默认：AGENTS.md)

🧬 SKILL.md 格式

OpenSkills 使用与 Anthropic 完全相同的格式：

---
name: pdf
description: Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/s

numman-ali/openskills