Claude Skills 是什么：技能、脚本与插件组成的资料库
Claude Skills 底层结构：源目录、镜像与客户端适配
追踪一个技能从作者目录到插件市场或本地安装目录的路径
Claude Skills 底层结构：源目录、镜像与客户端适配知识学习CN编辑简报更新 2026-10-04
你将学会
- 定位源包
- 看清分发层
- 保留信任边界
开始前需要
- 可丢弃的测试项目
- 固定的仓库提交
- 一个支持的 Agent 客户端
把目录里的一个条目变成可测量的团队决策
先看结论
- 镜像是分发入口，不是源文件目录。
- 市场元数据与安装器各有职责。
- 执行仍受客户端权限约束。
定位源包
真实领域目录存放 SKILL.md，有的还包括脚本和参考资料。示例 agent-harness 描述的是一套工作流程，并不是常驻服务。
仓库另有插件元数据和不同 Agent 的镜像目录。Windows 克隆时镜像可能只是软链接文本，所以检查复制后的实际 SKILL.md，比数目录条目更可靠。
看清分发层
Claude 插件市场 JSON 把插件指向源目录。Codex 使用索引和镜像树，安装器从中选择条目、跟随链接，再复制到客户端技能目录。
其他工具的转换脚本会产生不同格式的规则。文字被转换并不代表触发条件、脚本权限都相同，适配输出本身需要测试。
保留信任边界
SKILL.md 会作为 Agent 输入，附带工具则可能作为代码运行。市场列表不为其中任何一项提供沙箱；客户端权限、文件范围和人工批准依然独立存在。
这里是固定版本的源码结构图，不代表所有客户端加载方式完全一致。先跟踪一个技能在一个客户端中的全流程。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
找到真实领域技能目录。
- 2
追踪市场或镜像条目到目标位置。
- 3
在目标客户端测试激活和脚本。
可复制示例
text
真实技能目录 -> 市场元数据
真实目录 -> 镜像与索引 -> Codex 复制
真实目录 -> 格式转换 -> 客户端规则常见问题
一个 SKILL.md 就是完整技能吗？
不一定；有些技能还依赖脚本、模板或参考资料，要检查完整目录。
转换后在 Cursor 和 Codex 一定等价吗？
不能保证；格式相同不代表触发及权限相同。
资料来源
- Claude Skills / README.md来源核查 2026-10-04
- Claude Skills / .claude-plugin/marketplace.json来源核查 2026-10-04
- Claude Skills / scripts/codex-install.sh来源核查 2026-10-04
- Claude Skills / scripts/convert.sh来源核查 2026-10-04
- Claude Skills / scripts/install.sh来源核查 2026-10-04
- Claude Skills / engineering/agent-harness/skills/agent-harness/SKILL.md来源核查 2026-10-04