Skill Authoring

Use this skill to create or improve Agent Skills that work across Claude Code, Codex, and the skills CLI.

Workflow

Clarify the reusable capability the skill should capture.
Choose a narrow lowercase kebab-case name and create skills/<name>/SKILL.md.
Put the trigger surface in the description: what the skill does, when to use it, and concrete task phrases that should activate it.
Keep the SKILL.md body short and procedural. Move long material into references/, repeatable code into scripts/, and reusable output files into assets/.
Avoid agent-specific frontmatter by default. Add compatibility only when the skill needs a specific environment or product.
Validate the skill and test discovery with the skills CLI.

Read references/standards.md before making structural decisions about frontmatter fields, directory layout, or install behavior.