Babysitter writing-skills

Use when creating new skills, editing existing skills, or verifying skills work before deployment.

install
source · Clone the upstream repo
git clone https://github.com/a5c-ai/babysitter
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/a5c-ai/babysitter "$T" && mkdir -p ~/.claude/skills && cp -r "$T/library/methodologies/superpowers/skills/writing-skills" ~/.claude/skills/a5c-ai-babysitter-writing-skills && rm -rf "$T"
manifest: library/methodologies/superpowers/skills/writing-skills/SKILL.md
source content

Writing Skills

Overview

Writing skills IS Test-Driven Development applied to process documentation. Write pressure tests, watch agents fail, write the skill, watch them pass, close loopholes.

Core principle: If you did not watch an agent fail without the skill, you do not know if the skill teaches the right thing.

TDD for Skills

TDD ConceptSkill Creation
Test casePressure scenario with subagent
Production codeSkill document (SKILL.md)
REDAgent violates rule without skill
GREENAgent complies with skill present
REFACTORClose loopholes

Skill Structure

  • YAML frontmatter:
    name
    and
    description
    only
  • Description: "Use when..." (triggering conditions only, never summarize workflow)
  • Flat namespace, separate files only for heavy reference or reusable tools

Tool Use

Meta-skill for creating new skills within the methodology.