garrytan/skill-creator

Skill Creator

Contract

This skill guarantees:

• New skill follows conformance standard (frontmatter + required sections)
• MECE check: no overlap with existing skills' triggers
• Manifest.json updated
• RESOLVER.md updated with routing entry
• Skill passes conformance tests (bun test test/skills-conformance.test.ts)

Phases

1. Identify the gap. What capability is missing? What user intent has no skill?
2. MECE check. Review skills/manifest.json and skills/RESOLVER.md. Does any existing skill already cover this? If so, extend it instead of creating a new one.
3. Create SKILL.md. Use this template:

---
name: {skill-name}
version: 1.0.0
description: |
  {One paragraph describing what the skill does and when to use it.}
triggers:
  - "{trigger phrase 1}"
  - "{trigger phrase 2}"
tools:
  - {tool1}
  - {tool2}
mutating: {true|false}
---

# {Skill Title}

## Contract
{What this skill guarantees — 3-5 bullet points}

## Phases
{Numbered workflow steps}

## Output Format
{What good output looks like}

## Anti-Patterns
{What NOT to do — 3-5 items}

## Tools Used
{GBrain operations used, with descriptions}

4. Add to manifest. Update skills/manifest.json with name, path, description.
5. Add to resolver. Update skills/RESOLVER.md with routing entry in the appropriate category.
6. Verify. Run bun test test/skills-conformance.test.ts to confirm the new skill passes.

Output Format

New skills/{name}/SKILL.md file + updated manifest + updated resolver.

Anti-Patterns

• Creating a skill that overlaps with an existing one (violates MECE)
• Skipping the MECE check against existing skills
• Creating a skill without triggers in frontmatter
• Not updating manifest.json and RESOLVER.md
• Creating a skill without an Anti-Patterns section