What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide or capability that defines patterns, tools, and best practices to enhance Claude's behavior when performing specific tasks.

How does Claude Search Optimization (CSO) work?

CSO involves using specific 'Use when...' descriptions and keywords that allow Claude to accurately identify and load the most relevant skill for the user's current task.

How can I keep my skills token-efficient?

You can save context by moving heavy reference data to external files, using concise code examples, and referencing other skills rather than repeating their content.

Why apply TDD to documentation and skills?

Using TDD (Test-Driven Development) for skills ensures they are necessary and effective by verifying that an agent fails a task without the skill and succeeds once the skill is implemented.

Why shouldn't I summarize workflows in the skill description?

Summarizing the workflow in the description can lead Claude to follow the summary instead of reading the full skill content, potentially missing critical details and multi-step logic.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: zoosewu

byzoosewu

0•

学習とドキュメンテーション

Standardizes the creation and optimization of Claude Code skills using a Test-Driven Development approach to ensure agent compliance.

This skill provides a rigorous framework for developing and documenting new capabilities for Claude Code. By applying Test-Driven Development (TDD) principles to documentation, it ensures that every skill is validated against actual agent behavior, resulting in reliable, token-efficient, and easily discoverable instructions. It guides users through creating effective descriptions, keyword optimization, and structural patterns that prevent Claude from skipping critical instructions or taking inefficient shortcuts.

主な機能

01Test-Driven Development (TDD) mapping for documentation lifecycle

02Standardized YAML frontmatter and Markdown structural templates

03Graphviz flowchart integration for non-obvious decision logic

040 GitHub stars

05Claude Search Optimization (CSO) for improved skill discovery

06Token-efficient documentation patterns to save context window space

ユースケース

01Refining existing skills to improve AI agent adherence to rules

02Optimizing documentation for high-frequency usage and discoverability

03Creating new domain-specific capabilities for Claude Code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zoosewu/mackup writing-skills

For use in Claude.ai and ChatGPT

Download Skill