How does this help with token efficiency?

The methodology enforces strict line count targets (typically 120-140 lines) and requires removing any content that doesn't directly address a verified failure scenario.

What is Claude Search Optimization (CSO)?

CSO is a technique for writing skill descriptions that focus on 'Use when' triggers and natural phrasing rather than summaries, ensuring Claude loads the skill exactly when needed.

Why use TDD for writing Claude skills?

TDD ensures that every line of a skill solves a specific failure mode, preventing documentation bloat and ensuring the skill actually improves the AI agent's performance.

When should I NOT create a skill?

Avoid creating skills for one-time procedures, information easily found in standard documentation, tool-specific configuration better suited for CLAUDE.md, or content under 30 lines.

What are 'pressure scenarios' in this context?

Pressure scenarios are specific situations where the AI agent is demonstrably likely to fail without the guidance provided by the skill. They serve as the 'failing tests' for your documentation.

Writing Skills & TDD Authoring

Name: Writing Skills & TDD Authoring
Author: TechDufus

byTechDufus

•

Gestión de Contenido

Applies TDD principles to the creation of high-efficiency Claude Code skills through pressure testing and aggressive refactoring.

The Writing Skills skill provides a rigorous methodology for authoring, editing, and reviewing Claude Code skills using a Test-Driven Development (TDD) approach. By treating process documentation like production code, it ensures every instruction in a skill addresses a specific failure scenario, meets the minimum criteria for success, and remains token-efficient through strict length targets. This methodology prevents documentation bloat and ensures that Claude only loads skills that solve demonstrable problems, resulting in more reliable agent behavior and optimized context usage.

Características Principales

01Pressure scenario identification to verify the necessity of new skills

02Strict token efficiency guidelines with specific line count targets

03Claude Search Optimization (CSO) patterns for better trigger matching

04Standardized SKILL.md structural templates for consistency

0585 GitHub stars

06Red-Green-Refactor workflow for documentation and skill authoring

Casos de Uso

01Creating high-performance custom skills for the oh-my-claude ecosystem

02Refactoring existing documentation to reduce context window usage

03Auditing skill quality by testing against documented failure modes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add techdufus/oh-my-claude writing-skills

For use in Claude.ai and ChatGPT

Download Skill