How does this skill help with token efficiency?

It provides specific word-count targets and techniques like moving details to tool help or using cross-references to keep frequently-loaded skills concise.

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide for proven techniques, patterns, or tools that helps Claude instances find and apply effective approaches to specific tasks.

Why apply TDD to writing skills?

TDD ensures that a skill actually teaches the right thing. By watching an agent fail without the skill (Red) and pass with it (Green), you verify the documentation's impact.

Why shouldn't I summarize the workflow in the skill description?

If the description summarizes the workflow, Claude may follow the summary and skip the full skill content, often leading to missed instructions or shallow execution.

Skill Writing & TDD Documentation

Name: Skill Writing & TDD Documentation
Author: clsandoval

byclsandoval

0•

Learning & Documentation

Standardizes the creation and optimization of Claude Code skills using a Test-Driven Development (TDD) methodology.

This skill applies the Red-Green-Refactor cycle of Test-Driven Development to process documentation and agent instructions. It provides a structured framework for creating new skills, verifying their effectiveness through pressure scenarios, and optimizing them for Claude's discovery mechanism. By focusing on specific triggering conditions and token efficiency, it ensures that Claude correctly identifies, loads, and follows complex instructions without skipping critical steps or exhausting context windows.

Key Features

01Red-Green-Refactor workflow for process documentation

02Claude Search Optimization (CSO) guidelines for discovery

03Token-efficient documentation and cross-referencing patterns

04Pressure testing protocols for verifying agent compliance

05Standardized SKILL.md structure and YAML frontmatter

060 GitHub stars

Use Cases

01Fixing inconsistent agent behavior through proven implementation patterns

02Developing new domain-specific capabilities for autonomous agents

03Refactoring existing documentation to reduce context token usage

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add clsandoval/monorepo writing-skills

For use in Claude.ai and ChatGPT