codex安装skill需要准备什么

安装一个 Codex Skill 之前，需要确认三项基础条件是否就绪：本地 Codex 环境已经启动并且能正常响应指令、技能包的结构要合规（必须包含 SKILL.md 文件）、目标安装路径要有写入权限。这三样缺一不可，否则后续操作就是白费力气。

确认 Codex 运行环境

打开终端或命令行，先执行 codex --version。如果返回一个版本号，比如 CLI v0.132.0，那就说明 CLI 已经正确安装并可用。要是提示 command not found，那就得先完成 CLI 的安装——Node.js ≥20 加上 npm ≥10 是硬性前提，这个跑不了。

如果是桌面版用户，请确保 App 已经完全启动。不是图标在任务栏闪烁就算数，得主窗口加载完毕，能正常接收对话输入才算。未登录账号时，部分 Skill 会拒绝加载，这一点必须注意。

准备 Skill 包本身

每个 Skill 包必须包含一个名为 SKILL.md 的根文件，这是 Codex 识别技能的唯一入口。没有这个文件，整个文件夹都会被忽略，直接跳过。

从 GitHub 下载的压缩包，需要完整解压，不能保留 zip 的层级嵌套。举个例子，解压后应该直接看到 my-skill/SKILL.md，而不是 my-skill-master/my-skill/SKILL.md。后者这种嵌套结构，会导致 Codex 扫描不到技能，白费功夫。

如果技能包里还包含 scripts/ 或 assets/ 目录，不用手动处理，Codex 会自动识别并加载。但要注意，references/ 中的关键依赖文档（比如 api.md）别删掉，否则运行时可能会报错，提示“missing reference”。

定位并校验安装目录

第一步，先确认系统类型，找到对应的路径：

Windows 用户路径是 C:Users你的用户名.codexskills；macOS 用户路径是 ~/.codex/skills/；Linux 用户和 macOS 一样。

第二步，进入那个目录，检查一下是否存在 .gitignore 或其他隐藏配置文件。如果有，请勿删除——这些文件是用来防止误提交敏感信息的，留着就好。

第三步，尝试新建一个空文本文件，命名为 test.txt 并保存。如果系统提示“权限被拒绝”，说明当前用户没有写入权限。这时候需要右键目录→属性→安全→编辑→勾选“写入”权限，否则把 Skill 复制过去也没法生效。

选择安装方式

方法一：交互式安装（适合新手，推荐优先考虑）

在终端里运行 skills install --interactive，然后按提示选择技能类型（系统/精选/实验性）、确认目标路径、决定用符号链接还是复制模式。这种方式会自动校验 SKILL.md 的结构，一旦有缺失项会直接提示，省心不少。

方法二：命令行直装（适合批量操作）

执行 skills install file-converter --type=curated，其中 file-converter 是技能名，--type=curated 指定存入精选目录。注意，技能名必须与 GitHub 仓库名或本地文件夹名完全一致，而且大小写敏感，写错了就找不到。

方法三：手动拖放（仅限本地 Skill）

把解压后的整个 Skill 文件夹（比如 hatch-pet/）直接复制进 .codex/skills/ 目录。完成之后，重启 Codex App，或者点击界面右上角 Skills 插件里的刷新按钮。