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: ```yaml --- 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} ## When it fails Follow the [agent operator protocol](../conventions/agent-operator-protocol.md) for any gbrain error `code`, exit code, `[AGENT]` block or notice block. Specific to this skill: {2-5 concrete failures this skill hits — error codes, refusals, notices — and what to do and tell the user} ## 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. ## When it fails Follow the [agent operator protocol](../conventions/agent-operator-protocol.md) for any gbrain error `code`, exit code, `[AGENT]` block or notice block. Specific to this skill: - `bun test test/skills-conformance.test.ts` fails: the new SKILL.md lacks a required section (Contract, Anti-Patterns, Output Format, When it fails) or frontmatter; add it and re-run. - `gbrain check-resolvable` reports the skill unreachable: add the RESOLVER row in a fitting category, then re-run. ## 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