What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide that provides domain-specific guidance, patterns, and tools to enhance Claude's behavior during specific tasks.

What is Claude Search Optimization (CSO)?

CSO is the practice of structuring skill descriptions so Claude can easily find and trigger them. It focuses on using 'Use when' statements that describe triggering conditions rather than summarizing workflows.

Where are personal Claude Code skills stored?

Personal skills for Claude Code are typically stored in the ~/.claude/skills directory, organized by skill-specific subdirectories.

How do I keep my Claude skills token-efficient?

To save context, keep high-frequency skills under 200 words, move heavy reference material to separate files, and use cross-references instead of repeating instructions.

Why apply TDD to documentation?

Using TDD for skills ensures that the documentation actually solves a problem. By watching an agent fail a task without the skill (RED) and pass it with the skill (GREEN), you verify the skill's effectiveness.

Skill Writing & Documentation TDD

Name: Skill Writing & Documentation TDD
Author: mance-cyber

bymance-cyber

Aprendizaje y Documentación

Applies Test-Driven Development principles to create and refine high-quality documentation for Claude Code skills.

Acerca de

This skill provides a structured framework for authoring Claude Code skills using a specialized Red-Green-Refactor cycle adapted for documentation. It treats process documentation as production code and pressure scenarios as test cases, ensuring that every skill created is verified to change agent behavior effectively. The skill includes comprehensive guidelines on Claude Search Optimization (CSO), token efficiency, and standardized directory structures to maximize the discoverability and performance of custom AI capabilities.

Características Principales

Token efficiency techniques to minimize context window usage
Pressure scenario testing to verify agent compliance and behavior change
0 GitHub stars
Test-Driven Development (TDD) workflow for process documentation
Claude Search Optimization (CSO) strategies for better skill discovery
Standardized SKILL.md templates and directory structures

Casos de Uso

Optimizing shared team documentation for better AI search results
Developing new domain-specific skills for complex engineering workflows
Refactoring existing skills to close loopholes and improve agent adherence

Acerca de

Características Principales

Token efficiency techniques to minimize context window usage
Pressure scenario testing to verify agent compliance and behavior change
0 GitHub stars
Test-Driven Development (TDD) workflow for process documentation
Claude Search Optimization (CSO) strategies for better skill discovery
Standardized SKILL.md templates and directory structures

Casos de Uso

Optimizing shared team documentation for better AI search results
Developing new domain-specific skills for complex engineering workflows
Refactoring existing skills to close loopholes and improve agent adherence