| name | create-skill |
| description | Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork, README links, discovery metadata, and validation. Use when the user asks to create a new skill, add a skill to this collection, turn a workflow into a reusable skill, or make a skill's documentation and artwork consistent with the repository. |
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
-
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.
-
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.
-
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.
