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}

## When it fails
Follow the [agent operator protocol](../../docs/protocol/AGENT_OPERATOR_v1.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 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