Why use TDD for writing skills?

Applying TDD ensures the skill actually changes agent behavior. By watching an agent fail without the skill (Red) and pass with it (Green), you prove the documentation is effective.

How do I ensure my skills are token-efficient?

You can maintain efficiency by moving heavy references to external files, using cross-references instead of repeating instructions, and keeping code examples minimal.

When should I create a new skill instead of updating CLAUDE.md?

Create a skill when a technique applies broadly across different projects. Use CLAUDE.md for project-specific conventions and local constraints.

What is Claude Search Optimization (CSO)?

CSO is a set of practices, such as using 'Use when...' in descriptions, that helps Claude accurately identify and load the most relevant skill for a specific task.

What is a Claude Code Skill?

A skill is a specialized reference guide for proven techniques, patterns, or tools that enhances Claude's behavior when performing specific tasks.

Skill Authoring TDD

Name: Skill Authoring TDD
Author: MeechYourGoals

byMeechYourGoals

•

Productivity & Workflow

Streamlines the creation and verification of Claude Code skills using a robust Test-Driven Development (TDD) approach for process documentation.

This skill provides a systematic framework for developing effective Claude Code skills by applying TDD principles to documentation. It guides users through creating pressure scenarios, establishing baseline failures, and iteratively refining skill definitions to ensure agents comply with complex instructions and patterns. By focusing on the 'Red-Green-Refactor' cycle, authors can verify that their skills genuinely solve performance gaps and are optimized for discovery through Claude Search Optimization (CSO) best practices.

Key Features

01Standardized SKILL.md structure with YAML frontmatter validation

02Red-Green-Refactor workflow for documentation and process guides

03Token-efficient documentation patterns and cross-referencing

04Claude Search Optimization (CSO) for improved skill discovery

052 GitHub stars

06Pressure scenario testing using subagent verification

Use Cases

01Verifying existing skills work as intended before deploying to a team

02Creating new domain-specific capabilities and patterns for Claude Code

03Refactoring complex documentation to prevent agent 'workflow shortcuts'

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add meechyourgoals/chravel writing-skills

For use in Claude.ai and ChatGPT

Download Skill