openskills 是什么？

OpenSkills 是一个开源 CLI 工具，它通过标准化格式和统一管理机制，让 AI 编程助手（如 Claude Code、Cursor、Windsurf 等）能够跨平台、跨工具地使用“技能”（Skills）。

简单来说，它就像 AI 编程助手的“应用商店”和“包管理器”，解决了不同工具间技能格式不兼容、难以迁移的痛点。

1. 核心概念：什么是 Skill？

Skill 是 AI 编程助手的“插件”或“工具箱”，它不是一个可执行程序，而是一套Markdown 格式的指令集。一个 Skill 通常包含以下结构：

my-skill/
├── SKILL.md # 核心指令（包含 YAML 元数据）
├── scripts/ # 可执行脚本（Python/Bash）
├── references/ # 参考文档
└── assets/ # 静态资源

SKILL.md 示例：

name: pdf-editor
description: 工业级 PDF 操控工具集
allowed-tools: "Read,Write,Bash"

核心动作：PDF 合并

当用户提出“合并多个 PDF”时，执行以下流程：

1. 校验输入文件

2. 调用 scripts/merge_pdfs.py

3. 输出结果

4. 工作原理：渐进式披露

OpenSkills 采用“渐进式披露”（Progressive Disclosure）机制，以最小化 AI 的认知负荷：

• Layer 1: 元数据（始终加载）：AI 只加载技能的名称和描述，用于快速判断任务是否匹配。

• Layer 2: 核心指令（按需加载）：当任务匹配时，AI 才读取 SKILL.md 的详细内容，获取具体操作步骤。

• Layer 3: 资源文件（条件加载）：仅在需要时（如遇到异常或复杂逻辑），AI 才会加载 references/ 中的参考文档或执行 scripts/ 中的脚本。

这种机制避免了将所有信息一次性塞入上下文，显著降低了 API 调用成本并提升了推理速度。

3. 核心功能与使用流程

4. 安装与配置

# 1. 安装 OpenSkills CLI
npm install -g openskills

# 2. 安装技能（以官方技能库为例）
openskills install anthropics/skills --universal

# 3. 同步技能信息到项目
openskills sync

执行 sync 后，会在项目根目录生成 AGENTS.md 文件，AI 助手通过读取这个文件来发现可用的技能。

2. 技能管理

• 查看技能：openskills list

• 读取技能内容：openskills read

• 更新技能：openskills update

• 卸载技能：openskills remove

4. 核心优势

• 跨生态复用：一次编写，到处运行。符合 OpenSkills 规范的技能包，无需修改即可在 Claude Code、Cursor、Windsurf 等主流 AI 工具中无缝使用。

• 执行确定性：通过“SKILL.md 定逻辑 + 脚本定执行”的模式，将技能行为固化为可复现的工程流程，避免了 AI 的“自由发挥”和幻觉。

• 上下文经济：通过渐进式加载，大幅减少了上下文窗口的占用，降低了 API 调用成本。

• 可运维性：技能包支持 Git 版本控制，便于团队协作和 CI/CD 集成。

5. 典型应用场景

• 团队协作：将公司内部的开发规范、代码模板、API 文档制作成 Skill，通过 OpenSkills 分发给团队成员，确保 AI 助手的行为一致性。

• 复杂工作流：处理 PDF 文档、数据提取、代码质量分析等需要多步骤、多工具协作的复杂任务。

• 多工具切换：如果你同时使用 Cursor 和 Claude Code，OpenSkills 可以让你在两个工具间无缝切换，而无需重新配置技能。

总结：

OpenSkills 是 AI 编程助手生态中的“粘合剂”，它通过标准化协议和 CLI 工具，将原本分散在不同工具中的能力统一起来，让开发者能够像管理代码依赖一样管理 AI 技能，真正实现了 AI 编程的工程化。

OpenSkills 跟claude 之间是怎么联系的

OpenSkills 和 Claude 之间是通过文件系统和上下文窗口进行“通信”的，它们之间没有直接的 API 调用或网络连接。这种设计使得 OpenSkills 可以作为一个独立于任何特定 AI 工具的通用技能管理器。

以下是它们之间建立联系的具体机制：

1. 核心桥梁：AGENTS.md 文件

OpenSkills 的核心命令是 openskills sync。当你执行这个命令时，它会扫描你安装的技能，并将这些技能的元数据（名称、描述、触发条件等）汇总写入一个名为 AGENTS.md 的文件中。

• Claude 的角色：Claude 在分析你的项目时，会读取项目根目录下的 AGENTS.md 文件。

• 信息的传递：通过读取这个文件，Claude 就知道了“这个项目里有哪些可用的技能”。

2. 工作流程（数据流）

整个联系过程可以看作一个“数据流”：

1. 用户操作：你在终端执行 openskills install 安装技能。

2. OpenSkills 处理：OpenSkills 将技能文件下载到本地目录（通常是 .claude/skills/ 或 .cursor/skills/）。

3. 生成索引：执行 openskills sync，OpenSkills 生成/更新 AGENTS.md 文件。

4. Claude 发现：当你向 Claude 提问时，Claude Code 或 Claude Desktop 会自动将 AGENTS.md 的内容加载到上下文窗口中。

5. Claude 调用：Claude 识别到你的问题匹配某个技能，然后根据 AGENTS.md 中的路径指引，去读取对应的技能文件（如 SKILL.md）来执行具体操作。

6. 关键特性：渐进式披露

这种联系机制支持 “渐进式披露”，这是为了节省宝贵的上下文窗口（Token）：
• 第一步（轻量）：Claude 只读取 AGENTS.md 里的技能列表。如果用户的问题不匹配任何技能，Claude 就不会去加载技能的具体内容，节省了 Token。

• 第二步（按需）：只有当用户的问题触发了某个技能时，Claude 才会去读取对应的 SKILL.md 文件，获取详细的指令和代码。

总结

你可以把 OpenSkills 看作一个“图书管理员”，而 Claude 是“读者”。
• OpenSkills 负责整理书架（管理技能文件）和编写图书目录（生成 AGENTS.md）。

• Claude 通过查看目录（读取 AGENTS.md）来知道有哪些书（技能）可用，然后根据目录的指引去书架上拿具体的书（读取 SKILL.md）来阅读和执行。