必须将 skill 文件夹整体放入 codex 固定路径(windows:c:\users\%username%.codex\skills;macos/linux:~/.codex/skills),文件夹名须为纯英文小写且不含空格或中文,重启客户端后通过 / 命令或 codex --list-skills 验证是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Codex 中使用本地开发或下载的 Skill,必须将技能文件正确放置到 Codex 能识别的路径中,否则调用时会提示“未找到 skill”或直接报错退出。
确认 Codex 的 skills 根目录位置
Windows 用户打开资源管理器,地址栏输入:【C:\Users\%USERNAME%\.codex\skills】 → 回车。如果该路径不存在,手动创建 .codex 文件夹和其下的 skills 子文件夹。
macOS/Linux 用户在终端执行:ls ~/.codex/skills。若提示“No such file”,则运行:mkdir -p ~/.codex/skills。
这一步不可跳过——Codex 只认这个固定路径,放错位置(比如桌面、文档、项目根目录)会导致 skill 完全不可见。
把 Skill 文件夹放进对应目录
解压你下载的 Skill ZIP 包(如 ppt-skill-main),得到一个含 manifest.json 和 main.py 等文件的文件夹。
将整个文件夹(不是里面的内容)拖入上一步确认的 .codex/skills/ 目录中。例如:把 ppt-skill-main 文件夹整体放入 ~/.codex/skills/,最终路径为 ~/.codex/skills/ppt-skill-main/manifest.json。
【文件夹名不能含空格或中文】,否则 Codex 启动时可能解析失败,后续调用报 skill not found。建议重命名为纯英文小写,如 ppt_skill 或 meeting_notes。
验证 Skill 是否生效
重启 Codex 桌面客户端(不重启,新 skill 不会被加载)。
在聊天窗口输入 /,稍等片刻,下拉列表中应出现你刚放入的 skill 名称(如 /ppt_skill)。
若未出现,打开终端执行:codex --list-skills,检查输出里是否包含你的 skill 文件夹名。没有则说明路径错误或 manifest.json 缺失/格式错误。










