Codex Desktop 的自定义 Skill 必须存放在 ~/.codex/skills/ 目录下,路径中 skills 文件夹必须全小写、不可重命名或嵌套;Windows、macOS、Linux 的完整路径分别为 C:Users.codexskills、/Users//.codex/skills/、/home//.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
Windows:explorer "%USERPROFILE%.codexskills"
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI,等待编码任务完成,并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时,使用此功能。
方法二:在文件管理器中手动导航到 ~/.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 对象(不能以注释开头)。










