When should I create a new skill versus updating CLAUDE.md?

Create a skill for reusable techniques or patterns that apply across multiple projects. Use CLAUDE.md for conventions specific only to a single repository.

What is Claude Search Optimization (CSO)?

CSO is a set of practices for writing skill descriptions and keywords that ensure Claude correctly identifies and loads the right skill for a given situation.

Why apply TDD to documentation?

TDD ensures documentation actually works by forcing you to verify that an agent fails a specific task without the skill and passes it only once the skill is applied.

What is a Claude Code Skill?

A skill is a specialized reference guide for proven techniques, patterns, or tools that enhances Claude's behavior and judgment during specific domain tasks.

How does this skill help with token limits?

It provides strict word-count targets and architectural patterns, like moving heavy references to secondary files, to keep core skills context-efficient.

Skill Writing & Documentation TDD

Name: Skill Writing & Documentation TDD
Author: lgbarn

bylgbarn

0•

Aprendizaje y Documentación

Implements Test-Driven Development principles for creating and maintaining high-performance Claude Code skills and process documentation.

The Writing Skills plugin transforms process documentation into a rigorous engineering discipline by applying the Red-Green-Refactor cycle to skill authoring. It ensures that every documented technique is validated through pressure scenarios—verifying that Claude fails without the skill and succeeds with it—while optimizing for discovery through Claude Search Optimization (CSO). This framework prevents Claude from taking 'shortcuts' and ensures documentation is concise, token-efficient, and only loaded when truly relevant to the current task.

Características Principales

01Red-Green-Refactor workflow for documentation validation

020 GitHub stars

03Graphviz flowchart integration for non-obvious decision paths

04Claude Search Optimization (CSO) patterns for better discovery

05Standardized SKILL.md templates with optimized frontmatter

06Token-efficiency guidelines for context window management

Casos de Uso

01Verifying the efficacy of process documentation through baseline failure testing

02Developing new domain-specific capabilities for Claude Code

03Refactoring verbose documentation into token-efficient reference guides

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lgbarn/devops-skills writing-skills

For use in Claude.ai and ChatGPT

Download Skill