OpenSkills:让每个 AI 编程助手都能用上 Claude Skills

Claude Skills 让 AI 按需加载专业能力，但换到 Cursor 就全失效？OpenSkills 用一条 CLI 把技能装进项目、同步进 AGENTS.md，任何能读该文件的 Agent 都能按需加载——帮你把 AI 技能变成可复用资产。

你有没有经历过这种崩溃：

在 Claude Code 里精心调教了一整套 Skills——写公众号、审合规、排版配图，样样顺手。换到 Cursor 继续干活，Agent 却像失忆了一样，每次都要你重新解释「我们团队怎么写稿、用什么格式、有哪些禁忌」。

Skills 明明已经写好了，为什么不能跨工具复用？

先搞懂：Skills 到底是什么

简单说，Skill 就是一份带触发条件的专业说明书。

每个 Skill 是一个文件夹，核心是 SKILL.md：里面写清楚「什么时候该用这个能力」「具体怎么执行」「有哪些脚本和参考资料」。Agent 平时不会把全部 Skill 塞进上下文——只有任务匹配时，才按需加载对应 Skill，这就是 渐进式披露（Progressive Disclosure）。

Claude Code 原生支持这套机制。但 Cursor、Windsurf、Aider 等工具并不直接读 .claude/skills/ 里的文件。它们有自己的规则体系，比如 Cursor 读 AGENTS.md 或 .cursor/rules/。

痛点就在这里：Skills 格式是通用的，加载入口却不统一。

程序员在多个编辑器图标间切换，略显困惑

OpenSkills 做了什么

OpenSkills 的定位很直白：Universal Skills Loader——把 Anthropic 的 Skills 体系搬到每一个 AI 编程 Agent 上。

它做两件事：

1. 安装（install） 从 GitHub、本地路径或私有仓库，把 Skill 装进 .claude/skills/（项目级）或 ~/.claude/skills/（全局）。

2. 同步（sync） 把已安装的 Skills 列表写入项目根目录的 AGENTS.md，生成与 Claude Code 相同格式的 XML 块。任何能读 AGENTS.md 的 Agent，就知道有哪些 Skill 可用。

运行时按需加载：

npx openskills read <skill-name>

Agent 在 shell 里执行这条命令，Skill 全文输出到 stdout，等同于 Claude Code 里的 Skill(「name」) 工具调用。

Claude Code Skills 与 OpenSkills 对比，列=存储位置/加载方式/适用 Agent

三步上手，今天就能跑通

第一步：安装 OpenSkills

npm install -g openskills # 或一次性使用 npx openskills install anthropics/skills

默认装到当前项目的 .claude/skills/。想全局共享，加 --global 装到 ~/.claude/skills/。

Anthropic 官方技能库 anthropics/skills 里有 PDF 处理、DOCX、PPT、前端设计等 20+ 实用 Skill，拿来就能用。

第二步：同步到 AGENTS.md

npx openskills sync

这一步有个容易踩的坑：

openskills sync 默认是交互式的。如果你把 Skill 装在全局（~/.claude/skills/），而 AGENTS.md 还是空的，交互界面里 global skills 默认不会被勾选——直接按 Enter，等于「不同步任何 Skill」，文件还是空的。

解决办法：

# 跳过交互，同步全部 skills openskills sync -y  # 或装到项目级，交互模式下会默认勾选 npx openskills install anthropics/skills   # 不加 --global

install 到 sync 到 AGENTS.md 到 Agent read 四步闭环

第三步：让 Agent 按需读取

配置好后，AGENTS.md 里会出现类似这样的块：

<available_skills> <skill> <name>pdf</name> <description>Comprehensive PDF manipulation toolkit...</description> <location>project</location> </skill> </available_skills>

Agent 遇到 PDF 相关任务时，执行 npx openskills read pdf，完整 Skill 指令加载进上下文，按专业流程处理。

谁最适合用 OpenSkills

创业者 / 自由职业者——如果你一个人扛内容、代码、文档多条线，Skills 能把「怎么做公众号」「怎么审合规」「怎么排版」固化成可复用流程，换编辑器也不丢。

小团队——把 .claude/skills/ 和 AGENTS.md 提交进 Git，队友 clone 下来 openskills sync -y，全员同一套 AI 工作流。

多 Agent 用户——Claude Code 写后端、Cursor 改前端、Windsurf 做 Review，一套 Skills 处处可用。

手动重复 prompt 与 Skills 复用，效率与一致性差异

几个实用命令备忘

openskills 六条核心命令与作用对照表

命令	作用
`openskills list`	查看已安装的 Skills
`openskills install`	从 GitHub / 本地安装
`openskills sync [-y]`	同步到 AGENTS.md
`openskills read`	加载 Skill 内容
`openskills update`	更新已安装 Skills
`openskills manage`	交互式管理 / 删除

写在最后

AI 工具换得越来越快，但你的方法论不应该跟着工具一起丢。

Skills 把「怎么做」从对话里抽出来，变成可版本化、可共享、可迭代的资产。OpenSkills 则是那座桥——让 Claude Code 生态里的 Skills，真正服务于你手头的每一个 Agent。

如果你今天只记一件事：装完 Skill 别忘 sync -y。不然 AGENTS.md 空着，Agent 照样「看不见」你的技能库。

你目前在用哪些 AI 编程工具？有没有自己写过 Skill？欢迎聊聊你的实践。

觉得有用？点个关注，持续获取 AI 提效干货。