安装Codex Skill前须确认三项条件：Codex环境已启动并可响应、技能包含SKILL.md文件、安装路径具备写入权限；需验证CLI版本、App运行状态、账号登录，并校验路径权限与技能结构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装 Codex Skill 前必须确认三项基础条件是否就绪：本地 Codex 环境已启动且可响应指令、技能包结构合规（含必需的 SKILL.md 文件）、目标安装路径具备写入权限，缺一不可。
确认 Codex 运行环境
打开终端或命令行，执行 codex --version。若返回类似 CLI v0.132.0 的版本号，说明 CLI 已正确安装并可用；若提示 command not found，需先完成 CLI 安装（Node.js ≥20 + npm ≥10 是硬性前提）。
桌面版用户请确保 App 已完全启动——不是图标在任务栏闪烁，而是主窗口已加载完毕，能正常接收对话输入。未登录账号时部分 Skill 会拒绝加载，【必须完成账号登录或 API Key 配置】，否则后续所有安装操作将静默失败。
准备 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\你的用户名\.codex\skills\；macOS 用户路径为 ~/.codex/skills/；Linux 用户同 macOS 路径规则。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
第二步：进入该目录，检查是否存在 .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 插件里的刷新按钮——【不重启或不刷新，新技能不会出现在列表里】。
