When is it appropriate to create a new skill?

Create a skill when a technique is not intuitively obvious, applies broadly across projects, or serves as a valuable reference guide for others.

How does Claude Search Optimization (CSO) work?

CSO uses rich descriptions starting with 'Use when...', relevant keywords, and token-efficient formatting to help Claude accurately discover and load the right skill for a task.

What is the Red-Green-Refactor cycle for AI skills?

It involves creating a pressure scenario to watch the AI fail (Red), writing a minimal skill to fix the behavior (Green), and then refining the skill for efficiency and clarity (Refactor).

Why should descriptions only include triggering conditions?

Summarizing workflows in the description field can cause Claude to skip reading the full skill content, leading to incomplete execution of complex tasks.

Skill Writing & Documentation TDD

Name: Skill Writing & Documentation TDD
Author: axiomantic

byaxiomantic

0•

학습 및 문서화

Standardizes the creation of Claude Code skills using a Test-Driven Development (TDD) approach to ensure AI compliance and documentation accuracy.

This skill adapts the fundamental Red-Green-Refactor cycle of Test-Driven Development to the process of writing AI documentation and agent skills. It guides users through creating pressure scenarios to identify baseline AI failures, drafting documentation to solve specific issues, and verifying compliance through rigorous testing. By focusing on 'Use when' triggers and Claude Search Optimization (CSO), it ensures that AI agents consistently reference full documentation rather than relying on brief, potentially misleading summaries, leading to more reliable and maintainable AI skillsets.

주요 기능

01Claude Search Optimization (CSO) best practices

02Red-Green-Refactor documentation workflow

03Standardized SKILL.md frontmatter and structure

04Token-efficient documentation patterns

05Pressure-test validation for agent compliance

060 GitHub stars

사용 사례

01Refining existing AI documentation to improve agent adherence

02Creating new specialized capabilities for Claude Code or Codex

03Standardizing team-wide patterns and technical reference guides

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add axiomantic/spellbook writing-skills

For use in Claude.ai and ChatGPT

Download Skill