Codex Skill安装后无反应、图标灰显、命令面板搜不到，根本原因是环境未对齐：需先确认codex --version正常、codex界面可问答，再确保Skill置于正确路径（Windows为C:\Users\用户名.codex\skills，macOS/Linux为~/.codex/skills）且为独立子目录含SKILL.md，最后通过codexctl list验证并修复YAML元数据、openai.yaml注册及UTF-8 BOM问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex Skill安装后输入指令没反应、图标灰显、命令面板搜不到，不是技能坏了，而是环境没对齐。很多新手卡在重启这一步，或者把文件扔进错的文件夹，导致整个流程中断。
确认 Codex 本体是否正常运行
打开终端，执行：codex --version。能正确输出版本号（如 Codex version 2.8.3），说明基础环境就绪；如果报 command not found 或卡住超过10秒，先别碰 Skills，回头检查 PATH、安装包完整性或重装 Desktop 客户端。
接着在任意项目目录下运行：codex。等待界面弹出并能完成一次普通问答（例如问“当前时间”），才算真正跑通。这一步不通过，Skills 绝对不会加载——【Codex 进程未启动成功，Skills 就没有执行容器】。
检查 Skill 是否真的落在正确路径
Windows 用户路径是：C:\Users\用户名\.codex\skills；macOS/Linux 是：~/.codex/skills。不要放在桌面、下载目录、项目根目录或自己新建的 my-skills 文件夹里。
进入该 skills 文件夹，确认你安装的 Skill 是一个**独立子目录**，且其内部直接包含 SKILL.md 文件（不是套在 skills/figma-implement-design/skills/ 这种多层结构里）。常见错误是 git clone 后没进子目录就整体复制，结果多了一层嵌套，Codex 解析器会跳过整个文件夹。
如果路径正确但仍然不识别，打开终端执行：codexctl list --installed。若输出为空或显示 [missing]，说明 Codex 根本没扫描到任何有效 Skill；此时立刻检查文件夹权限（Windows 上尤其注意是否被系统标记为“来自互联网”，右键属性→解除锁定）。
强制重启并重建索引
第一步：彻底关闭 Codex 所有进程。Windows 用任务管理器杀掉所有 codex.exe 和 Code Helper；macOS 在活动监视器中结束 Codex 和 Electron 相关进程。
第二步：清除缓存与索引文件。
执行：rm -rf ~/.codex/cache（macOS/Linux）或手动删除 C:\Users\用户名\.codex\cache（Windows）；
再执行：rm -f ~/.codex/index.json 或删除同名文件。
第三步：重新打开 Codex Desktop。首次启动会自动重建插件索引，状态栏右下角会出现「Building skill index…」提示，持续约 3–6 秒。此期间不要点击任何技能指令，等提示消失后再测试。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
验证 Skill 名称与调用方式
方法一：在 Codex 界面中直接输入「请问我现在有哪些 skills 可以使用？」，它会列出全部已识别 Skill 的标准名称（如 playwright、gh-fix-ci），不是你压缩包名或文件夹名。
方法二：终端中运行：codexctl list --installed，核对输出是否含你安装的 Skill 名称及对应版本。若显示 [broken]，说明 SKILL.md 前置元数据（frontmatter）格式错误——最常踩的坑是 description 字段里写了 Triggers: /test 却没加引号，YAML 解析器直接崩溃，整个 Skill 被跳过。
调用时必须用列表中显示的**全小写+短横线**名称，例如输入「使用 figma-implement-design 把这个设计稿转成 React 组件」，而不是「figma」、「Figma」或「figma implement design」。
修复自定义 Skill 不显示问题
如果你是用官方 Skill Creator 工具生成的自定义 Skill，即使 SKILL.md 存在且路径正确，仍可能不显示。原因通常是：【缺少 agents/openai.yaml 中 display_name 和 short_description 字段注册】。
打开 ~/.codex/agents/openai.yaml（Windows 对应路径为 C:\Users\用户名\.codex\agents\openai.yaml），检查是否存在如下结构：
skills: - id: your-skill-id display_name: "Your Skill Name" short_description: "Does something useful"
若不存在，手动添加对应区块（注意缩进为两个空格）；若存在但字段值为空或格式错乱（比如用了 tab 而非空格），请修正。改完保存，重启 Codex。
另需检查 SKILL.md 文件开头是否有 UTF-8 BOM 头（EF BB BF），可用 VS Code 以“UTF-8 无 BOM”编码另存一遍，否则 frontmatter 解析失败，Skill 被静默忽略。
