What is a Claude Code skill?

A skill is a reference guide for proven techniques, patterns, or tools that helps future Claude instances find and apply effective approaches consistently.

Why use TDD for writing documentation?

Applying TDD to documentation ensures that the instructions actually solve a problem. By watching an agent fail without the skill first, you verify that the skill is necessary and effective.

How does this skill optimize for Claude search?

It provides a standardized 'Use when...' description format and naming conventions that help Claude's retrieval mechanism identify the right skill for a specific task.

What are subagents used for in skill writing?

Subagents are used as test subjects to run scenarios and verify if they follow the guidelines in the SKILL.md file before the skill is finalized.

What is the Red-Green-Refactor cycle in this skill?

It involves creating a pressure scenario (Red), writing the skill until the agent complies (Green), and then refining the language to close loopholes and save tokens (Refactor).

Skill Authoring TDD

Name: Skill Authoring TDD
Author: lifangda

bylifangda

•

学习与文档

Applies Test-Driven Development principles to create reliable, subagent-tested documentation and skills.

This skill transforms the way Claude Code skills are created by treating documentation as code. It implements a rigorous RED-GREEN-REFACTOR cycle where authors must first prove a skill is necessary by watching a subagent fail a pressure scenario. By documenting the agent's rationalizations and iteratively refining the skill until loopholes are closed, it ensures that every skill added to the library is functional, concise, and effectively steers AI behavior. It provides strict guidelines on structure, naming, and token efficiency to maximize the effectiveness of custom Claude workflows.

主要功能

01RED-GREEN-REFACTOR workflow for process documentation

02Pressure-testing with subagents to verify agent compliance

0316 GitHub stars

04Claude Search Optimization (CSO) naming and description patterns

05Strict token efficiency guidelines for skill files

06Standardized directory and SKILL.md structure templates

使用场景

01Refactoring existing documentation to close behavior loopholes and rationalizations

02Verifying agent adherence to complex process rules before library deployment

03Writing new Claude Code skills for custom domain-specific workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lifangda/claude-plugins writing-skills

For use in Claude.ai and ChatGPT

Download Skill