Create Skill

Turn a skill idea into a complete, discoverable, and shippable skill folder. Treat the skill instructions, metadata, artwork, README wiring, and validation as one deliverable.

Workflow

1. Orient the repository. Read AGENTS.md, the root README.md, the nearest existing skill with a similar purpose, and any local lessons file. Inspect package.json, skills.sh.json, the installer, and the existing assets/skill-cards/ and assets/skill-banners/ conventions before editing.

2. Define the contract. Extract the skill slug, purpose, audience, trigger phrases, inputs, outputs, and acceptance checks from the request. Normalize the slug to lowercase hyphen-case. Preserve the user's terminology, but make the frontmatter description explicit about both the capability and the situations that should trigger it.

3. Choose the smallest useful structure. Create only the resources the skill needs:

   • skills/<slug>/SKILL.md for the core workflow and routing rules.
   • skills/<slug>/agents/openai.yaml for display metadata and an explicit $<slug> default prompt.
   • skills/<slug>/references/ for detailed domain guidance that should load progressively.
   • skills/<slug>/scripts/ only for deterministic, repeatable automation.
   • skills/<slug>/assets/ only for files the skill will reuse in its outputs.
   • skills/<slug>/README.md because this repository documents every published skill.