OpenSkills

打破边界，让所有 AI 助手（Cursor, Windsurf, Aider）
都能拥有 Claude Code 强大的技能生态。

什么是 OpenSkills？

OpenSkills 将 Anthropic 的“技能（Skills）”系统解耦，让所有 AI 助手通过简单的命令行调用来动态加载指令，实现效率极高的“渐进式披露”（Progressive Disclosure）。

👤

用户提问
"分析PDF"

➜

🤖

AI 查阅
AGENTS.md

➜

⚡

后台执行
openskills read

➜

📄

加载具体
操作指南

🧩 跨平台兼容支持 Cursor, Windsurf, Aider 及 Claude Code。

📦 丰富的市场官方/社区技能一键安装，覆盖 PDF、Excel、Github 等。

🔄 自动同步智能更新项目配置，AI 即刻感知新能力。

💾 灵活存储支持项目级、用户级及代理共享级的三层存储模式。

如何使用 (How to use)

1. 安装工具与技能

安装核心 CLI 并下载你需要的技能包。

BASH npm i -g openskills

# 安装官方技能包 (推荐)
openskills install anthropics/skills
2. 同步配置 (Sync)

让当前项目的 AI 助手“认识”这些新技能。这也是最关键的一步。

BASH # 标准同步 (交互式选择需要启用的技能)
openskills sync

# 全自动同步(跳过询问)
openskills sync -y

# Cursor 专用同步 (写入 .cursorrules)
openskills sync --output .cursorrules
3. 高级：存储模式选择

你可以根据使用场景，将技能安装在不同位置：

Local (默认) .claude/skills/
仅限当前项目使用，适合项目特定脚本。

Global ~/.claude/skills/
你的个人工具箱，所有项目通用。

Universal .agent/skills/
适合多 Agent 协作场景。

BASH # 安装到全局目录，一次安装，处处可用
openskills install anthropics/skills --global
# 每当你进入一个新项目，只需要在项目根目录运行一次
npx openskills sync

跨平台调用技能

安装技能后（参见上方教程），即可让 Cursor、Windsurf、Aider 等 AI 编程工具也能调用 Claude 的技能生态。
💡 提示：对于非 Claude Code 软件，建议使用 --universal 模式安装，以确保兼容性。

🖱️ Cursor 在 Chat/Composer 中输入 @AGENTS.md，AI 会自动执行 read 命令加载技能。

🌊 Windsurf 在 Rules 中添加："Refer to AGENTS.md for skills and use openskills read to load them."

🤖 Aider 直接提示 AI："Read AGENTS.md to see what skills are available."

💡 为什么有效 按需加载：技能不占用 Token，只有 AI 执行 read 后才加载指令。

🛠️ 开发者指南：编写自定义技能

技能不仅可以是现成的，你可以将任何常用脚本（Python, Bash, Node）封装成 Skill。一个标准的技能包含一个 SKILL.md 文件。

                SKILL.MD 结构示例
                ---

                # 元数据 (YAML Frontmatter)

                name: my-image-optimizer

                description: 批量优化项目中的图片大小

                ---

                # Image Optimizer Guide

                当用户想要优化图片时，请参考以下步骤：

                1. 扫描 `assets` 目录。

                2. 运行脚本: `python .claude/skills/my-skill/optimize.py`

                ...

🚀 OpenSkills 命令速查表

类别	功能描述	完整命令	核心备注
基础命令	检查版本与帮助	`openskills --version` `openskills --help`	查看当前安装版本或获取即时帮助
基础安装	安装官方示例技能库	`npx openskills install anthropics/skills`	默认安装到当前项目
全局安装	安装到 Claude 目录	`npx openskills install <来源> --global`	最推荐，和你现有的 22 个技能共存
通用安装	安装到独立目录	`npx openskills install <来源> --universal`	存放在 `~/.agent`，不干扰官方工具
本地安装	从本地文件夹导入	`npx openskills install ./my-local-skill`	适合你自己编写的自定义技能
项目同步	生成技能索引文件	`npx openskills sync` `npx openskills sync -y`	必跑！运行后 AI 才能看到技能 (-y 参数可跳过确认直接同步)
查看技能	列出所有已安装技能	`npx openskills list`	检查 22 个技能是否已被成功识别
交互管理	可视化删除/清理	`npx openskills manage`	弹出列表，勾选即可删除不再需要的技能
读取技能	查看特定技能指令	`npx openskills read <技能名>`	通常由 AI 自动调用，你也可以手动查看内容
更新技能	同步远程仓库更新	`npx openskills update`	如果是从 GitHub 安装的，用此命令拉取最新版
工具升级	升级核心 CLI	`npm i -g openskills@latest`	将 openskills 工具本身升级到最新版
彻底删除	移除指定技能	`npx openskills remove <技能名>`	物理删除对应的技能文件夹

常见问题 (FAQ)

1. OpenSkills 和 MCP (Model Context Protocol) 有什么区别？

MCP 适用于动态工具（如实时查询数据库、搜索网页），需要运行服务器。 OpenSkills 专注于静态指令和资源（如代码规范、PDF 流程），不需要服务器，跨编辑器兼容性更好，且完全符合 Anthropic 的 SKILL.md 规范。

2. 为什么我的 AI 助手不肯主动调用技能？

AI 可能没意识到它有这个能力。解决方案： 确保在聊天中引用了 @AGENTS.md。 进阶技巧： 在项目的 .cursorrules 或 .windsurfrules 中添加提示："遇到复杂任务先查阅 AGENTS.md 中的可用技能并运行 npx openskills read 加载。"

3. 我可以不用安装 npm 运行它吗？

不可以。OpenSkills 是 Node.js 工具，但不需要全局安装，直接使用 npx openskills <命令> 即可自动运行最新版。

4. 运行 npx openskills sync 报错或无反应？

通常是路径或版本问题。请检查 Node.js 版本是否在 20.6 以上，并确保在项目根目录下运行。

5. 如何分享我写的技能？

将你的技能文件夹（含 SKILL.md）上传到 GitHub。他人只需运行 npx openskills install 用户名/仓库名 即可安装。

6. 技能安装在 .agent 还是 .claude 文件夹？

默认安装到 .claude/skills。如果使用 --universal 参数，则安装到 .agent/skills。建议多平台用户使用 --universal 以避免冲突。

7. 每次都要运行 sync 命令吗？

只有当增加新技能、删除旧技能或修改技能描述时才需要运行。它负责刷新 AGENTS.md 菜单。

8. 为什么 AI 运行 read 后还是不会做？

OpenSkills 只是"搬运工"。如果 SKILL.md 里的指令不清晰，AI 依然无法执行。请确保 # Instructions 部分逻辑严密。

9. 如何一次性卸载所有技能？

本地： 删除项目根目录下 .agent 或 .claude 文件夹及 AGENTS.md。
全局： 删除 ~/.agent 或 ~/.claude。或使用 npx openskills manage 批量删除。

10. 使用 OpenSkills 会消耗更多 Token 吗？

反而会节省。 这是"按需加载"的优势：不使用时 AI 只读 AGENTS.md 的简介（消耗极少）；只有需要时才读取具体的 SKILL.md。相比将所有规范塞进 System Prompt，大大降低了成本。

11. 我安装了新技能，为什么 AI 不知道？

答：每次 install 新技能后，必须运行一次 openskills sync 来更新配置文件。这是最容易被遗忘的步骤。

12. 我可以手动修改 AGENTS.md 吗？

答：可以，但请保留自动生成的 XML 标签，否则下次同步时工具找不到插入位置。建议只修改描述文本，不要动结构。

13. 如何升级 OpenSkills 核心工具？

答：如果你之前是全局安装了 openskills 命令行工具，可以通过以下命令升级到最新版本：npm install -g openskills@latest

资源来源: numman-ali/openskills | 整理: AI智囊团