How do I keep skills token-efficient?

By moving tool details to --help flags, using cross-references instead of repeating content, and keeping examples minimal and high-impact.

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

If the description summarizes the workflow, Claude may follow the summary and skip the detailed skill body, leading to missed steps or incomplete execution.

What is Claude Search Optimization (CSO)?

CSO is a set of techniques, including using specific 'Use when' triggers and keyword coverage, to ensure Claude can find and load the correct skill for a task.

What is a Claude Code Skill?

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

How does TDD apply to documentation?

It involves creating a 'pressure scenario' where the agent fails, writing the skill, and then verifying the agent complies with the new instructions, followed by refactoring.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: unclecatvn

byunclecatvn

•

Aprendizaje y Documentación

Applies Test-Driven Development principles to the creation and optimization of specialized Claude Code skills.

Acerca de

This skill provides a rigorous framework for developing Claude Code skills by treating process documentation like production code. By following a specialized RED-GREEN-REFACTOR cycle, it guides users to create pressure scenarios that identify baseline agent failures before writing documentation, ensuring that every skill effectively teaches the right behavior. It emphasizes Claude Search Optimization (CSO), token efficiency, and structured SKILL.md templates to ensure custom capabilities are easily discoverable and strictly followed by the AI during complex tasks.

Características Principales

Claude Search Optimization (CSO) for better skill discovery
Test-Driven Development (TDD) mapping for documentation
Token-efficient writing guidelines to minimize context usage
1 GitHub stars
Standardized SKILL.md frontmatter and structure templates
Graphviz flowchart integration for complex decision logic

Casos de Uso

Standardizing documentation for complex internal APIs and tools
Creating reusable engineering patterns for team-wide Claude deployments
Debugging and refining agent behavior through baseline failure testing

Acerca de

Características Principales

Claude Search Optimization (CSO) for better skill discovery
Test-Driven Development (TDD) mapping for documentation
Token-efficient writing guidelines to minimize context usage
1 GitHub stars
Standardized SKILL.md frontmatter and structure templates
Graphviz flowchart integration for complex decision logic

Casos de Uso

Standardizing documentation for complex internal APIs and tools
Creating reusable engineering patterns for team-wide Claude deployments
Debugging and refining agent behavior through baseline failure testing