用途：这是 EliteForge 系列技能的编写规范，供创建新 eliteforge-* 技能或修改已有技能时使用。
必要流程：每个新技能和每次实质性更新都须激活并遵循 skill-creator；新技能用 skill-creator 的 scripts/init_skill.py 初始化，除非技能目录已存在。SKILL.md 须简洁且具权威性，强制性的智能体行为写入 SKILL.md，细节放 references/ 按需加载。保持 agents/openai.yaml 与最终 SKILL.md 一致。完成前运行 skill-creator 校验器；若校验器不可用或失败且与本次改动无关，应报告阻塞而非声称校验成功。
Frontmatter 约定：每个 eliteforge-* 技能须在 SKILL.md 顶部 YAML frontmatter 声明 metadata.version，形如 name、description、metadata 下的 version: 1.0.0；版本用 MAJOR.MINOR.PATCH 语义化文本，只放在 frontmatter metadata 内，不迁到 agents/openai.yaml、references 或正文；已有其他 metadata 字段则保留并并列添加 version；更新尚无版本的旧技能时一并补上。
环境变量约定：使用用户可配置环境变量的技能须在顶层 SKILL.md 的固定 ## Environment Variables 节声明，每变量一条项目符号，名称用 SCREAMING_SNAKE_CASE，格式为 ELITEFORGE_SKILL_<SKILL_ABBREV>_<PURPOSE>；标记只能是 [optional]、[required]、[conditional]，[conditional] 描述须含机器可读条件如 ELITEFORGE_SKILL_POSEIDON_AUTH_TYPE=API_TOKEN；不得在输出、报告、校验日志或示例中打印密钥值；不使用则省略该节。
输出路径约定：向工作区写用户可见产物的技能须在顶层固定 ## Output Path 节按显式优先级解析主产物路径，涉及环境变量需同节声明；说明归一化规则与派生产物相对主产物路径的关系；不写产物则省略。
agent-doctor 约定：eliteforge-agent-doctor 是环境就绪扫描器，默认只扫顶层 skills/eliteforge-*/SKILL.md，只解析各顶层 ## Environment Variables 节，报告 missing_required、missing_conditional、optional_unset 三类，仅前两类（生效的 conditional）作为就绪阻塞，忽略 references、模板、命令示例和脚本中的变量提及。
评审清单：确认 frontmatter 含 metadata.version、强制规则在 SKILL.md、每个环境变量有合规顶层声明、每个写产物的技能有合规 ## Output Path、可选变量有安全默认或回退、必需或条件密钥不被回显，并在最终回复前运行 skill-creator 校验。定价、平台等信息暂未提供。