What is the Iron Law of skill creation?

No skill should be created or edited without a failing test first. If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.

What is TDD for documentation?

It is the practice of testing an AI agent's failure on a task before writing the instructions to fix it, ensuring the documentation is truly effective and necessary.

How does this help with Claude's context window?

The skill provides strict guidelines for token efficiency, moving heavy references to external files and keeping core instructions under specific word counts.

Why use subagents for testing skills?

Subagents allow you to simulate specific pressure scenarios to see if an agent complies with your documentation or finds loopholes through rationalization.

TDD for Documentation Skills

Name: TDD for Documentation Skills
Author: franroa

byfranroa

0•

学習とドキュメンテーション

Applies Test-Driven Development principles to creating, verifying, and refining documentation and skills for AI agents.

This skill adapts the Red-Green-Refactor cycle of TDD to the process of writing AI instructions and skills. By forcing authors to watch an agent fail a pressure scenario before writing the documentation, it ensures that every instruction is necessary, effective, and resilient against agent rationalizations. It provides a structured framework for creating high-performance, token-efficient skills that Claude can reliably discover and execute across different projects.

主な機能

01Claude Search Optimization (CSO) guidelines

02Red-Green-Refactor workflow for documentation

030 GitHub stars

04Token-efficient documentation patterns

05Standardized SKILL.md structure

06Subagent pressure-testing framework

ユースケース

01Optimizing documentation for AI discoverability and context efficiency

02Refining existing instructions to prevent agent hallucinations

03Creating new specialized skills for Claude Code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add franroa/chezmoi writing-skills

For use in Claude.ai and ChatGPT

Download Skill