Codex Desktop 的自定义 Skill 必须存放在 ~/.codex/skills/ 目录下，路径中 skills 文件夹必须全小写、不可重命名或嵌套；Windows、macOS、Linux 的完整路径分别为 C:Users<user>.codexskills、/Users/<user>/.codex/skills/、/home/<user>/.codex/skills/；需完全退出并重启 Codex 才能识别，且文件须为 .skill.json 格式、首行为有效 JSON 对象。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Codex Desktop 中安装或手动添加自定义 Skill（技能）时，这些 Skill 文件必须放在 Codex 能主动扫描并加载的固定目录下，否则界面不会显示、调用会失败，甚至触发 silent fail——你点了按钮却没反应，也无报错提示。
Codex Skill 文件的标准存放路径
所有 Skill 文件（.skill.json 或打包为 .zip 的技能包）统一存放在 ~/.codex/skills/ 目录中。
该路径中的 ~ 代表当前用户主目录，具体展开如下：
| 系统 | 完整路径示例 |
|---|---|
| Windows | C:Users\.codexskills |
| macOS | /Users//.codex/skills/ |
| Linux | /home//.codex/skills/ |
⚠️ 注意：skills 文件夹必须全部小写，且不能改名、不能嵌套在子文件夹内。例如 .codex/skills/my-skill/ 是合法结构，但 .codex/SKILLS/ 或 .codex/skills/community/my-skill/ 均无效。
如何快速进入 skills 目录
方法一：直接打开终端（VS Code 集成终端或系统终端），执行以下命令之一：
macOS / Linux：open ~/.codex/skills
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
Windows：explorer "%USERPROFILE%.codexskills"
方法二：在文件管理器中手动导航到 ~/.codex 后，确认已启用“显示隐藏项目”，再双击进入 skills 文件夹。若该文件夹不存在，请手动新建，名称必须为全小写 skills。
验证 Skill 是否被正确识别
第一步：确保 Codex Desktop 已完全退出（任务栏右下角托盘图标也要右键退出，不要仅关窗口）。
第二步：将 Skill 文件（如 git-commit.skill.json）复制进 ~/.codex/skills/ 目录。
第三步：重新启动 Codex Desktop → 点击左侧边栏「Skills」图标 → 等待 3～5 秒。
如果 Skill 出现在列表中且状态为「Ready」，说明路径和格式均正确；若仍为空白或显示「No skills installed」，请检查：文件扩展名是否为 .skill.json（不是 .json 或 .txt），且文件内容第一行必须是有效的 JSON 对象（不能以注释开头）。
