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.

主な機能

Claude Search Optimization (CSO) for better skill discovery
Test-Driven Development (TDD) mapping for documentation
Token-efficient writing guidelines to minimize context usage
1 GitHub stars
Standardized SKILL.md frontmatter and structure templates
Graphviz flowchart integration for complex decision logic

ユースケース

Standardizing documentation for complex internal APIs and tools
Creating reusable engineering patterns for team-wide Claude deployments
Debugging and refining agent behavior through baseline failure testing

概要

主な機能

Claude Search Optimization (CSO) for better skill discovery
Test-Driven Development (TDD) mapping for documentation
Token-efficient writing guidelines to minimize context usage
1 GitHub stars
Standardized SKILL.md frontmatter and structure templates
Graphviz flowchart integration for complex decision logic

ユースケース

Standardizing documentation for complex internal APIs and tools
Creating reusable engineering patterns for team-wide Claude deployments
Debugging and refining agent behavior through baseline failure testing