What is Claude Search Optimization (CSO)?

CSO involves structuring the description and keywords in a SKILL.md file so that Claude can accurately find and load the relevant skill when a specific problem occurs.

What does it mean to apply TDD to documentation?

It means writing a test case (a pressure scenario) for an AI agent first, watching the agent fail without the documentation, then writing the documentation and verifying that the agent now succeeds.

How do subagents help in this process?

Subagents act as the 'test runners' in the documentation TDD cycle, providing a baseline of how an agent handles tasks without project-specific context.

Why is the 'Red' phase important for writing skills?

The Red phase ensures you are solving a real problem; if an agent doesn't fail without the skill, the documentation might be redundant or addressing the wrong symptoms.

TDD Writing Skills

Name: TDD Writing Skills
Author: AlabamaMike

byAlabamaMike

Learning & Documentation

Applies Test-Driven Development principles to documentation and skill creation to ensure bulletproof AI agent compliance.

About

The Writing Skills skill introduces a rigorous Test-Driven Development (TDD) approach to creating documentation and AI-specific skills. By following a Red-Green-Refactor cycle—where subagents are used to test documentation efficacy before it is finalized—this skill helps developers eliminate AI rationalization and close instructional loopholes. It provides a standardized framework for writing, testing, and optimizing skills to ensure they are discoverable and actionable by Claude Code and Codex agents.

Key Features

Subagent pressure-testing for instruction verification
Token-efficient documentation patterns for context saving
Claude Search Optimization (CSO) for enhanced skill discovery
0 GitHub stars
Red-Green-Refactor workflow adapted for documentation
Standardized SKILL.md templates and frontmatter formatting

Use Cases

Creating reusable Claude Code skills for specialized domain knowledge
Verifying that documentation successfully guides agent behavior before deployment
Refactoring existing project guides to prevent AI hallucinations and rationalizations

About

Key Features

Subagent pressure-testing for instruction verification
Token-efficient documentation patterns for context saving
Claude Search Optimization (CSO) for enhanced skill discovery
0 GitHub stars
Red-Green-Refactor workflow adapted for documentation
Standardized SKILL.md templates and frontmatter formatting

Use Cases

Creating reusable Claude Code skills for specialized domain knowledge
Verifying that documentation successfully guides agent behavior before deployment
Refactoring existing project guides to prevent AI hallucinations and rationalizations