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

0•

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

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.

主な機能

01Claude Search Optimization (CSO) for improved skill discovery

02TDD-based workflow for documentation (Red-Green-Refactor)

03Standardized YAML frontmatter and SKILL.md directory structure

040 GitHub stars

05Categorization of skills into Techniques, Patterns, and References

06Pressure scenario testing to identify agent rationalizations

ユースケース

01Refactoring existing AI guidelines to eliminate agent non-compliance

02Developing high-reliability internal skills for complex engineering teams

03Standardizing documentation for custom toolchains and private APIs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add eyadsibai/ltk writing-skills

For use in Claude.ai and ChatGPT

Download Skill