What is the Iron Law of skill creation?

The Iron Law states that no skill should be created or edited without a failing test case first, proving the documentation actually solves a specific failure mode.

How do I keep my Claude skills token-efficient?

Focus on 'Use when...' triggers, move heavy references to separate files, and use explicit cross-references instead of repeating instructions across multiple skills.

What is a Claude Code Skill?

A skill is a specialized reference guide that provides Claude with proven techniques, patterns, or tools to improve its performance and consistency in specific domains.

What is Claude Search Optimization (CSO)?

CSO is the practice of optimizing skill descriptions and keywords so that Claude can accurately find and load the most relevant skills for a given task based on triggering conditions.

Why use TDD for writing documentation?

TDD ensures a skill actually works by requiring you to witness an agent failing a task before the documentation is written and passing it once the skill is applied.

Writing Skills for Claude Code

Name: Writing Skills for Claude Code
Author: yusoofsh

byyusoofsh

Aprendizaje y Documentación

Applies Test-Driven Development (TDD) principles to the creation and optimization of Claude Code skills through pressure-testing and subagent verification.

Acerca de

Writing Skills provides a rigorous framework for authoring and optimizing Claude Code skills using a Test-Driven Development (TDD) approach. By requiring developers to witness agent failure before writing documentation, it ensures every skill is bulletproof against AI rationalization and halluncination. The skill covers essential patterns for Claude Search Optimization (CSO), token-efficient documentation, and cross-referencing, helping users create high-impact, discoverable, and reliable process documentation for AI agents.

Características Principales

Subagent pressure-testing and verification techniques
Standardized SKILL.md structure and YAML frontmatter
Token-efficient writing patterns for low-context overhead
TDD-based documentation workflow (Red-Green-Refactor)
Claude Search Optimization (CSO) best practices
0 GitHub stars

Casos de Uso

Developing domain-specific AI guidance for complex legacy systems
Standardizing team-wide coding patterns and project conventions for AI agents
Optimizing existing Claude skills to reduce token consumption and improve reliability