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

학습 및 문서화

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.

주요 기능

Claude Search Optimization (CSO) best practices
Red-Green-Refactor documentation workflow
Standardized SKILL.md frontmatter and structure
Token-efficient documentation patterns
Pressure-test validation for agent compliance
0 GitHub stars

사용 사례

Refining existing AI documentation to improve agent adherence
Creating new specialized capabilities for Claude Code or Codex
Standardizing team-wide patterns and technical reference guides

소개

주요 기능

Claude Search Optimization (CSO) best practices
Red-Green-Refactor documentation workflow
Standardized SKILL.md frontmatter and structure
Token-efficient documentation patterns
Pressure-test validation for agent compliance
0 GitHub stars

사용 사례

Refining existing AI documentation to improve agent adherence
Creating new specialized capabilities for Claude Code or Codex
Standardizing team-wide patterns and technical reference guides