Codex 安装 Skill 时文件夹名和 SKILL.md 中 name 字段必须严格一致且符合规范：仅小写字母、数字、单连字符，64 字符内，不以连字符开头结尾，无空格/下划线/点号/中文；否则静默失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
给 Codex 安装新 Skill 时，如果名字不符合规范，系统会直接拒绝加载，连错误提示都不给——它就安静地当没看见这个文件夹。
官方强制要求的命名格式
Skill 文件夹名必须严格满足以下全部条件：
只允许小写字母、数字、连字符（-）；
长度不能超过 64 个字符；
【不能以连字符开头或结尾】；
【不能包含空格、下划线、点号、中文或其他特殊符号】；
例如 valid-skill-name-2026 和 api-client-v2 是合法的；invalid_skill、MySkill、skill name、-prefix、suffix-、skill..v1 都会被忽略。
SKILL.md 中 name 字段的规则
这个字段和文件夹名必须完全一致，大小写、连字符位置、数字都不能差一个字符。
打开 SKILL.md，检查 YAML frontmatter 里的 name 行：
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
---
name: your-skill-name
description: …
如果文件夹叫 your-skill-name，但这里写成 Your-Skill-Name 或 your_skill_name，Codex 就无法识别该 Skill。
这一步出错不会报错，只会静默失效——你反复重装也看不到它出现在技能列表里。
推荐的命名实践
第一步：用英文动词+名词组合，比如 git-pr-review、test-runner、env-validator；
第二步：删掉所有空格和标点，把驼峰转为连字符分隔，比如 setupProject → setup-project；
第三步：末尾加版本号（可选），用 v1、v2 而不是 1.0.0，避免点号；
第四步：用命令行快速校验：echo "your-skill-name" | grep -qE '^[a-z0-9]+(-[a-z0-9]+)*$' && echo "✅ 合法" || echo "❌ 不合法"；
注意：连字符不能连续出现，比如 my--skill 也不合法。
