必须将skill文件夹置于~/.codex/skills/（windows/macos/linux通用）才能被codex自动识别加载；若不存在需手动创建，名称严格为skills（全小写、无点、无空格、无下划线），且启用“显示隐藏项目”可见该隐藏目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你要给 Codex 添加自定义技能（skill），必须把 skill 文件夹放到它能自动扫描并加载的位置，否则无论文件写得多规范，Codex 都不会识别、更不会执行。
默认 skill 文件夹路径（Windows/macOS/Linux 通用）
Codex Desktop 会从 ~/.codex/skills/ 目录下自动加载所有子文件夹作为技能。这里的 ~ 指当前登录用户的主目录：
→ Windows：C:Users\.codexskills
→ macOS：/Users//.codex/skills/
→ Linux：/home//.codex/skills/
【注意】.codex 文件夹默认隐藏，必须在文件管理器中启用“显示隐藏的项目”才能看到它。若该 skills 文件夹不存在，请手动创建——不能用 .skill 或 skill.json 命名，必须是纯文件夹，且名字严格为 skills（全小写，无点、无空格、无下划线）。
如何验证 Codex 是否已识别 skill
打开 Codex Desktop → 点击左下角「设置」→ 进入「技能管理」页面 → 查看「已启用技能」列表是否出现你刚放入的文件夹名。
如果没出现，检查技能文件夹内是否包含有效的 manifest.json 文件（必须存在且格式合法），且该文件中 "id" 字段值不为空、不含特殊字符、不与已有技能重复。
非默认路径的两种替代方案
方法一：通过 config.toml 指定自定义路径
编辑 ~/.codex/config.toml，在文件末尾新增一行：
skill_paths = ["/your/custom/skill/folder/path"]
多个路径用英文逗号分隔，路径需为绝对路径，且每个路径下都需含符合规范的 skill 子文件夹。
方法二：启动时用命令行参数强制指定
关闭 Codex Desktop，在终端中运行：
codex --skill-paths="/path/to/your/skills"
该方式仅对本次启动生效，适合调试单个 skill，不推荐长期使用。
