How do I optimize skills for Claude's search discovery?

Use the 'Use when...' pattern in descriptions, focus on symptoms and triggering conditions, and avoid summarizing the workflow in the description field to force Claude to read the full skill content.

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide (SKILL.md) stored in your local directory that provides domain-specific patterns and tools to help Claude perform tasks more effectively.

Where are these skills stored?

Personal skills are typically stored in the ~/.claude/skills directory for Claude Code or ~/.agents/skills/ for Codex environments.

Why apply TDD to documentation?

TDD ensures a skill is actually effective. By watching Claude fail a task without the skill (Red), then pass after the skill is added (Green), you prove the documentation actually changes agent behavior.

What is the recommended structure for a skill?

A skill should follow a standardized SKILL.md format including YAML frontmatter, an overview, 'When to Use' triggers, core patterns, and common mistakes.

Claude Skill Writing TDD

Name: Claude Skill Writing TDD
Author: zhengxuyu

byzhengxuyu

0•

학습 및 문서화

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

This skill provides a standardized framework for documenting domain-specific expertise as Claude Code skills using a Red-Green-Refactor approach. By treating documentation like code—writing pressure tests with subagents to watch them fail before writing the skill—it ensures that guidance is effective and addresses actual model shortcomings rather than assumed ones. It includes specific patterns for Claude Search Optimization (CSO), token efficiency, and cross-referencing to maximize the utility of personal skills stored in ~/.claude/skills.

주요 기능

01Standardized SKILL.md structure with YAML frontmatter

02Test-Driven Development (TDD) mapping for process documentation

03Token-efficient documentation guidelines to preserve context window

040 GitHub stars

05Claude Search Optimization (CSO) patterns for better skill discovery

06Graphviz flowchart conventions for complex decision logic

사용 사례

01Verifying Claude follows custom instructions through pressure-test scenarios

02Creating reusable technique guides for complex engineering patterns

03Documenting organizational coding standards for AI compliance

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zhengxuyu/claude-superpowers writing-skills

For use in Claude.ai and ChatGPT

주요 기능

01Standardized SKILL.md structure with YAML frontmatter

02Test-Driven Development (TDD) mapping for process documentation

03Token-efficient documentation guidelines to preserve context window

040 GitHub stars

05Claude Search Optimization (CSO) patterns for better skill discovery

06Graphviz flowchart conventions for complex decision logic

사용 사례

01Verifying Claude follows custom instructions through pressure-test scenarios

02Creating reusable technique guides for complex engineering patterns

03Documenting organizational coding standards for AI compliance

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zhengxuyu/claude-superpowers writing-skills

For use in Claude.ai and ChatGPT