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 文件发布，并将其暴露在 `` 块中。当用户提出任务时，Claude 会动态加载匹配的技能。



pdf
Comprehensive PDF manipulation toolkit for extracting text and tables...
plugin

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

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

npx openskills read

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

对比概览

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

OpenSkills 写入的 AGENTS.md 格式示例：



## 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 ` (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  below
- Do not invoke a skill that is already loaded in your context





pdf
Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms...
project

🔧 安装技能

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

标志（Flags）

--global — 全局安装到 ~/.claude/skills（默认：项目安装）
--universal — 安装到 .agent/skills/ 而非 .claude/skills/
-y, --yes — 跳过提示（适用于 CI 环境）
-o, --output — 同步的输出文件（默认：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