How do I keep skills token-efficient?

By moving tool details to --help flags, using cross-references instead of repeating content, and keeping examples minimal and high-impact.

Why shouldn't I summarize the workflow in the description?

If the description summarizes the workflow, Claude may follow the summary and skip the detailed skill body, leading to missed steps or incomplete execution.

What is Claude Search Optimization (CSO)?

CSO is a set of techniques, including using specific 'Use when' triggers and keyword coverage, to ensure Claude can find and load the correct skill for a task.

What is a Claude Code Skill?

A skill is a specialized reference guide containing proven techniques, patterns, or tools that enhance Claude's behavior when performing specific tasks.

How does TDD apply to documentation?

It involves creating a 'pressure scenario' where the agent fails, writing the skill, and then verifying the agent complies with the new instructions, followed by refactoring.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: unclecatvn

byunclecatvn

•

학습 및 문서화

Applies Test-Driven Development principles to the creation and optimization of specialized Claude Code skills.

This skill provides a rigorous framework for developing Claude Code skills by treating process documentation like production code. By following a specialized RED-GREEN-REFACTOR cycle, it guides users to create pressure scenarios that identify baseline agent failures before writing documentation, ensuring that every skill effectively teaches the right behavior. It emphasizes Claude Search Optimization (CSO), token efficiency, and structured SKILL.md templates to ensure custom capabilities are easily discoverable and strictly followed by the AI during complex tasks.

주요 기능

01Claude Search Optimization (CSO) for better skill discovery

02Test-Driven Development (TDD) mapping for documentation

03Token-efficient writing guidelines to minimize context usage

041 GitHub stars

05Standardized SKILL.md frontmatter and structure templates

06Graphviz flowchart integration for complex decision logic

사용 사례

01Standardizing documentation for complex internal APIs and tools

02Creating reusable engineering patterns for team-wide Claude deployments

03Debugging and refining agent behavior through baseline failure testing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add unclecatvn/agent-skills writing-skills

For use in Claude.ai and ChatGPT

Download Skill