Skill Authoring & TDD Documentation

About

This skill provides a rigorous framework for developing and documenting new capabilities for Claude Code. By applying Test-Driven Development (TDD) principles to documentation, it ensures that every skill is validated against actual agent behavior, resulting in reliable, token-efficient, and easily discoverable instructions. It guides users through creating effective descriptions, keyword optimization, and structural patterns that prevent Claude from skipping critical instructions or taking inefficient shortcuts.

Key Features

• Test-Driven Development (TDD) mapping for documentation lifecycle
• Standardized YAML frontmatter and Markdown structural templates
• Graphviz flowchart integration for non-obvious decision logic
• 0 GitHub stars
• Claude Search Optimization (CSO) for improved skill discovery
• Token-efficient documentation patterns to save context window space

Use Cases

• Refining existing skills to improve AI agent adherence to rules
• Optimizing documentation for high-frequency usage and discoverability
• Creating new domain-specific capabilities for Claude Code