Why is token efficiency emphasized?

Frequently referenced skills are loaded into every conversation; keeping them concise (under 200 words) prevents unnecessary consumption of the context window.

How do I avoid Claude skipping my skill's workflow?

Ensure the skill description only lists triggering conditions (When to Use) rather than summarizing the internal process or workflow, which prevents the agent from taking shortcuts.

What is Claude Search Optimization (CSO)?

CSO is a strategy to ensure future Claude instances can find and load the correct skill by using specific 'Use when...' triggers and symptom-based keywords.

What is the core principle of this skill?

It treats skill documentation as code, applying Test-Driven Development to ensure instructions actually change AI behavior by watching the agent fail before the skill is applied.

Claude Skill Authoring & TDD

Name: Claude Skill Authoring & TDD
Author: majiayu000

bymajiayu000

•

Learning & Documentation

Applies Test-Driven Development principles to create high-performance, searchable documentation for Claude Code skills.

This skill provides a systematic framework for authoring Claude Code skills using a Red-Green-Refactor methodology. It ensures skills are discovered effectively by Claude through optimized descriptions and keyword coverage while maintaining token efficiency. By documenting agent failure patterns before writing solutions, developers can create reliable, context-aware instructions that prevent Claude from skipping detailed workflows, ensuring the AI correctly applies domain-specific guidance.

Key Features

01Pressure testing scenarios for agent validation

02Standardized SKILL.md template enforcement

03Claude Search Optimization (CSO) guidelines

04Token-efficient documentation patterns

05TDD-based skill creation workflow (Red-Green-Refactor)

061 GitHub stars

Use Cases

01Improving AI compliance through pressure testing documentation

02Building reusable domain-specific guidance for AI agents

03Optimizing system prompts for token-heavy developer environments

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add majiayu000/claude-skill-registry devops

For use in Claude.ai and ChatGPT

Download Skill