How do you apply TDD to documentation?

You create a scenario where an agent fails without the skill (Red), write the minimal skill content to make the agent comply (Green), and then refine the documentation to close any remaining loopholes (Refactor).

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide or capability that provides domain-specific patterns, techniques, or tool documentation to enhance Claude's performance in specific tasks.

What is the 'Iron Law' of skill creation?

The Iron Law dictates that no skill should be created or edited without first observing and documenting a failing test case where an agent violates the intended rule.

Why is the skill description field restricted to 'When to Use'?

If a description summarizes 'What the skill does,' Claude may rely on the short summary instead of reading the full, detailed documentation, leading to less accurate implementation.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: eyadsibai

byeyadsibai

학습 및 문서화

Standardizes the creation and verification of AI skills using Test-Driven Development principles to ensure reliable agent compliance.

소개

The Writing Skills framework adapts the Red-Green-Refactor cycle of Test-Driven Development to the creation of process documentation and AI behaviors. By requiring a failing 'pressure scenario' before any skill is written, it ensures that new capabilities address real-world agent failures rather than hypothetical needs. This skill provides a standardized structure for SKILL.md files, optimizes for Claude Search Optimization (CSO), and establishes the 'Iron Law' that documentation must be verified through subagent testing to close behavioral loopholes effectively.

주요 기능

Claude Search Optimization (CSO) for improved skill discovery
TDD-based workflow for documentation (Red-Green-Refactor)
Standardized YAML frontmatter and SKILL.md directory structure
0 GitHub stars
Categorization of skills into Techniques, Patterns, and References
Pressure scenario testing to identify agent rationalizations

사용 사례

Refactoring existing AI guidelines to eliminate agent non-compliance
Developing high-reliability internal skills for complex engineering teams
Standardizing documentation for custom toolchains and private APIs

소개

주요 기능

Claude Search Optimization (CSO) for improved skill discovery
TDD-based workflow for documentation (Red-Green-Refactor)
Standardized YAML frontmatter and SKILL.md directory structure
0 GitHub stars
Categorization of skills into Techniques, Patterns, and References
Pressure scenario testing to identify agent rationalizations

사용 사례

Refactoring existing AI guidelines to eliminate agent non-compliance
Developing high-reliability internal skills for complex engineering teams
Standardizing documentation for custom toolchains and private APIs