How do I keep my skills token-efficient?

The skill recommends moving heavy references to separate files, using cross-references instead of repeating instructions, and aiming for word counts under 200 for frequently loaded skills.

What is Claude Search Optimization (CSO)?

CSO is a method of writing skill descriptions focused on triggering conditions ('Use when...') rather than summaries, ensuring Claude correctly discovers and loads the skill when needed.

Why apply TDD to writing skills?

TDD ensures documentation is necessary and effective; by watching an agent fail first, you identify the exact gaps the skill needs to fill, preventing redundant or ignored instructions.

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide or capability stored in a specific directory (~/.claude/skills) that helps Claude apply proven techniques and patterns to tasks.

Skill Authoring TDD

Name: Skill Authoring TDD
Author: claudiodearaujo

byclaudiodearaujo

Learning & Documentation

Applies Test-Driven Development principles to the creation, verification, and refinement of AI skills and process documentation.

About

This skill adapts the rigorous Red-Green-Refactor cycle to the creation of Claude Code skills, ensuring that documentation effectively guides AI agents in real-world scenarios. By requiring authors to observe an agent failing a task before writing the skill, it eliminates guesswork and ensures that instructions directly address specific failure modes and logic gaps. It provides a standardized framework for building robust, token-efficient, and highly discoverable reference guides that enhance Claude's capabilities across any project.

Key Features

Standardized directory and frontmatter structures
Red-Green-Refactor workflow adapted for documentation
Pressure-testing strategies using subagent scenarios
Claude Search Optimization (CSO) for better skill discovery
Token-efficient formatting and progressive disclosure patterns
0 GitHub stars

Use Cases

Developing new reusable technical patterns for Claude Code
Verifying that documentation actually influences agent behavior before deployment
Refactoring existing workflows to be more concise and token-efficient

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/izacenter writing-skills

For use in Claude.ai and ChatGPT

Download Skill

GitHub