Codex 如何安装 Claude Skills？openskills 使用方法详解

很多人搜「Codex 怎么安装 Claude Skills」，其实装没装好不能只看命令有没有跑完，得同时满足三个结果才算数：技能文件已写入、AGENTS.md 里有对应索引、read 命令能正常返回指令。

先给 Codex 准备个能验收的项目

项目根目录得先装好 Node.js 20.6 以上版本和 Git。官方来源是 numman-ali/openskills；源码可用 git clone https://github.com/numman-ali/openskills.git 核对。OpenSkills 不需要 API Key，私有仓库得另外配 Git 凭据。

npx openskills install anthropics/skills --universal
npx openskills sync

加 --universal 参数会把技能写到 ./.agent/skills 目录，sync 命令用来创建或者更新 AGENTS.md。如果只是单个项目用，没必要装到全局。

命令跑完后，哪三个产物最关键？

技能实体：先看 SKILL.md

目标目录下应该会出现 .agent/skills/<name>/SKILL.md。文件头部的 name、description 字段说明技能身份和触发场景，正文和配套资源里存着具体执行内容。

任务入口：再看 AGENTS.md

AGENTS.md 里得有 <available_skills> 清单和目标技能名称。它只存索引，技能正文会按需读取。

怎样让 Codex 真正读到 Claude Skill？

npx openskills list
npx openskills read <skill-name>

list 命令得能列出技能名称、简介，还有是装在项目级还是全局；read 的有效输出要同时包含 Reading、Base directory、具体指令和 Skill read。你可以再建个符合技能描述的小任务验收；要是旧任务没重读规则，直接开新任务就行。

调用失败时，别急着重复安装

1. 找不到技能：先核对当前工作目录、输入的技能名和实际目录名对不对得上。
2. list 能查到但触发不了：重跑 sync，核对索引并刷新任务。
3. read 输出正常但执行报错：补齐依赖；密钥放到环境变量或者宿主配置里。
4. 私有源拉取失败：检查 Git 登录状态或者仓库权限有没有问题。

FAQ：update 和 sync 要不要每次都跑？

update 用来刷新技能文件，sync 用来刷新索引。如果是缺少来源元数据的旧安装，得重装一次才能更新。

Codex 端完成清单

• ./.agent/skills 下存在目标 SKILL.md 文件。
• AGENTS.md 收录了正确的技能名称。
• list 能明确标明安装位置。
• read 能正常返回指令和资源目录。
• 新任务能触发技能，依赖与密钥已单独配置好。

这套方案适合在 Codex 项目里复用技能；如果是一次性提示词，就没必要多装这一层了。