creating-skills

Installation
SKILL.md

Creating Skills

This skill provides guidance for creating effective skills using TDD methodology.

Core Principles

Skills ARE TDD for Documentation

  1. Write failing test first - Run pressure scenario WITHOUT skill, document rationalizations
  2. Write minimal skill - Address those specific failures
  3. Watch pass, refactor - Find new loopholes, plug them, re-test

If you didn't watch an agent fail without it, you don't know what to teach.

Concise is Key

The context window is a public good. Default assumption: Claude is already very smart. Only add context Claude doesn't already have. Challenge each piece: "Does Claude really need this explanation?"

Prefer concise examples over verbose explanations.

Installs
5
GitHub Stars
184
First Seen
Jan 22, 2026
creating-skills — reinamaccredy/maestro