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.

주요 기능

01Standardized SKILL.md structure with YAML frontmatter

02Pressure-test scenarios to verify agent compliance

03Token-efficient writing patterns to save context window space

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

05Claude Search Optimization (CSO) for better skill discovery

061 GitHub stars

사용 사례

01Standardizing team-wide workflows for AI-assisted development

02Building a private library of reusable coding patterns and techniques

03Optimizing agent performance by reducing instruction ambiguity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pur3v4d3r/pur3-pkb-codebase writing-skills

For use in Claude.ai and ChatGPT

Download Skill