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

0•

Learning & Documentation

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

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

01Subagent pressure-testing for instruction verification

02Token-efficient documentation patterns for context saving

03Claude Search Optimization (CSO) for enhanced skill discovery

040 GitHub stars

05Red-Green-Refactor workflow adapted for documentation

06Standardized SKILL.md templates and frontmatter formatting

Use Cases

01Creating reusable Claude Code skills for specialized domain knowledge

02Verifying that documentation successfully guides agent behavior before deployment

03Refactoring existing project guides to prevent AI hallucinations and rationalizations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alabamamike/copilot-agents writing-skills

For use in Claude.ai and ChatGPT

Download Skill