Example Skill
When To Use
Use this skill when converting a proven workflow, checklist, or repeatable review pattern into a reusable Codex skill.
Workflow
- Create the skill at
.agents/skills/<skill-name>/. - Add
SKILL.mdwith YAML frontmatter containing non-emptynameand a concise, front-loadeddescription. - Put only core trigger rules and workflow steps in
SKILL.md. - Add
references/only for background material that should be loaded conditionally. - Add
scripts/only for deterministic checks or repeated operations. - Add
assets/only for templates or binary resources used by the skill. - Add
agents/openai.yamlonly when UI metadata, policy, or dependencies are useful. - If this template validator is present, run
scripts/check.sh; otherwise validateSKILL.mdfrontmatter and any optional metadata with the repo's available checks.
Scripts
- Run
scripts/check.shafter editing this skill template.