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

Create a skill for broadly applicable patterns and reusable techniques. Use CLAUDE.md for project-specific conventions that don't apply to other codebases.

Why is token efficiency important for these skills?

Since frequently-referenced skills load into the conversation context, keeping them concise (ideally under 200 words) prevents them from consuming the AI's available memory.

How does TDD apply to writing documentation?

It follows the Red-Green-Refactor cycle: write a test scenario for a subagent, watch the AI fail the baseline, write the skill documentation, watch the AI comply, and then refactor for loopholes.

What is Claude Search Optimization (CSO)?

CSO is a set of strategies including rich triggers, keyword coverage, and active-voice naming designed to help Claude's search tools find the most relevant skill for a specific task.

What is a 'Skill' in Claude Code?

A skill is a reference guide for proven techniques, patterns, or tools that helps future Claude instances find and apply effective approaches across different projects.

Claude Writing Skills & TDD Documentation

Name: Claude Writing Skills & TDD Documentation
Author: hameed0342j

byhameed0342j

0•

학습 및 문서화

Applies Test-Driven Development principles to process documentation to ensure Claude instances discover and follow proven technical patterns.

Writing Skills provides a rigorous framework for creating Claude Code skills using a Test-Driven Development (TDD) approach. By treating documentation like production code—writing failing test scenarios with subagents before creating the documentation—developers can ensure their AI assistants actually follow the guidelines provided. This skill includes standardized templates for SKILL.md files, Claude Search Optimization (CSO) techniques to improve discoverability, and token-efficient formatting to maximize the AI's available context window while maintaining high performance across various technical domains.

주요 기능

01Validation strategies using subagent pressure testing scenarios

02Token-efficient documentation patterns to preserve context window

030 GitHub stars

04TDD-based documentation workflow (Red-Green-Refactor cycle)

05Standardized SKILL.md templates for techniques and patterns

06Claude Search Optimization (CSO) for enhanced skill discovery

사용 사례

01Validating that Claude follows specific architectural constraints

02Optimizing large documentation sets for AI-driven development

03Creating reusable technical guides for team-wide AI workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hameed0342j/svh writing-skills

For use in Claude.ai and ChatGPT