Why use TDD for writing documentation?

TDD ensures documentation is effective; by watching an agent fail without the skill, you verify that the instruction actually solves a real behavioral gap.

What is Claude Search Optimization (CSO)?

CSO is a set of practices, such as specific 'Use when...' description formats, that help Claude accurately identify and load the relevant skill for a given task.

What is a Claude Code Skill?

A skill is a specialized reference guide or technique in a standardized SKILL.md format that enhances Claude's behavior when performing specific tasks.

How does this skill improve token efficiency?

It provides specific patterns for cross-referencing and minimizing word counts in frequently-loaded skills to maximize the available context window.

How should I structure a new skill?

Every skill should include a YAML frontmatter with a name and description, followed by sections for Overview, When to Use, Core Patterns, and Implementation.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: pur3v4d3r

bypur3v4d3r

•

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

Applies Test-Driven Development principles to create, verify, and optimize Claude Code skills and specialized process documentation.

概要

This skill provides a rigorous framework for developing AI-native documentation by treating knowledge as code. By implementing a Red-Green-Refactor cycle for skill creation, it ensures that every instruction added to an agent's library is empirically verified to work and addresses specific failure modes. It includes advanced guidelines for Claude Search Optimization (CSO), token efficiency, and standardized directory structures, allowing developers to build a high-performance library of reusable techniques that Claude can discover and execute reliably.

主な機能

Standardized SKILL.md structure with YAML frontmatter
Pressure-test scenarios to verify agent compliance
Token-efficient writing patterns to save context window space
TDD-based documentation workflow (Red-Green-Refactor)
Claude Search Optimization (CSO) for better skill discovery
1 GitHub stars

ユースケース

Standardizing team-wide workflows for AI-assisted development
Building a private library of reusable coding patterns and techniques
Optimizing agent performance by reducing instruction ambiguity

概要

主な機能

Standardized SKILL.md structure with YAML frontmatter
Pressure-test scenarios to verify agent compliance
Token-efficient writing patterns to save context window space
TDD-based documentation workflow (Red-Green-Refactor)
Claude Search Optimization (CSO) for better skill discovery
1 GitHub stars

ユースケース

Standardizing team-wide workflows for AI-assisted development
Building a private library of reusable coding patterns and techniques
Optimizing agent performance by reducing instruction ambiguity