Skill 与 Codex Skills

name 和 description 用于发现与匹配。

my-skill/
├─ SKILL.md
├─ references/
│  └─ checklist.md
├─ scripts/
│  └─ validate.py
└─ assets/
   └─ report-template.md

正文给出命令式步骤和明确输入输出。

---
name: local-report-review
description: Review a local report against the supplied checklist. Use only when a report file is provided.
---

references、scripts、assets 按需使用，不应无条件全部加载。

1. Read the report and identify its format.
2. Load references/checklist.md only when checking coverage.
3. Run scripts/validate.py only after validating the input path.
4. Return findings, evidence, and unresolved questions.