skill-creatorlisted

# Skill Creator ## When to use this skill When adding a new skill to the harness, or when an existing skill is unclear, incomplete, or not triggering reliably. --- ## Creating a skill ### 1. Capture intent Before writing anything, answer: 1. What should this skill enable the AI developer to do? 2. When exactly should it trigger? (what user action or context) 3. What does a successful outcome look like? ### 2. Write the SKILL.md **Frontmatter fields:** - `name` — identifier, kebab-case - `description` — the primary trigger mechanism. Include what it does AND when to use it. Be specific enough that the AI picks this skill over doing something generic. Err toward being explicit rather than vague. Start from the template: [references/skill-template.md](references/skill-template.md) **Body sections** (use only what's needed): ```markdown ## When to use this skill ## Prerequisites ## Steps ## DO NOT ## Acceptance Criteria ``` **File structure** (when the skill needs supporting files): ``` skills/my-skill/ ├── SKILL.md ← instructions and pointers ├── references/ ← docs loaded into context as needed └── scripts/ ← reusable scripts (not reinvented every run) ``` Keep SKILL.md under 150 lines. If it's longer, move detail into `references/` and link to it. ### 3. Writing guidelines - Use imperative form: "Run X", "Check Y", not "You should run X". - Explain *why* behind non-obvious steps. AI developers follow reasoning better than bare commands.