How does Claude find and trigger these skills?

Claude uses Search Optimization (CSO) by reading the YAML description field to identify triggering conditions and symptoms that match the user's current task.

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide or capability that enhances Claude's behavior, providing domain-specific patterns and best practices for complex tasks.

What is the 'Red-Green-Refactor' cycle for skills?

It involves creating a pressure scenario (Red), writing the documentation to fix the agent's behavior (Green), and then tightening the logic to close loopholes (Refactor).

How can I make my Claude skills more token-efficient?

Efficiency is achieved by moving technical details to tool help menus, using cross-references instead of repeating instructions, and keeping word counts under strict targets.

Why use TDD for writing documentation?

Using Test-Driven Development ensures documentation is necessary and effective by verifying the agent fails without the skill and succeeds once the skill is applied.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: ZhanlinCui

byZhanlinCui

•

Productivity & Workflow

Applies Test-Driven Development principles to create, verify, and optimize specialized Claude Code skills and process documentation.

This skill adapts the Red-Green-Refactor cycle of Test-Driven Development to the creation of agent documentation, ensuring that every skill is effective and context-efficient. By requiring agents to verify baseline failures before documenting a solution, it guarantees that skills teach the right behaviors and close logical loopholes. It provides a standardized framework for Claude Search Optimization (CSO), token management, and structured SKILL.md authoring to help developers build a robust library of specialized agent capabilities.

Key Features

01Enforces token efficiency with word count targets and concise patterns

02Implements a TDD Red-Green-Refactor cycle for documentation accuracy

0317 GitHub stars

04Provides guidelines for cross-referencing without burning context tokens

05Standardizes YAML frontmatter and SKILL.md directory structures

06Optimizes skills for Claude Search Optimization (CSO) and discoverability

Use Cases

01Developing new domain-specific skills for Claude Code environments

02Refactoring verbose documentation into searchable, high-performance skill modules

03Verifying that existing documentation effectively changes agent behavior

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zhanlincui/ultimate-agent-skills-collection writing-skills

For use in Claude.ai and ChatGPT

Download Skill