Documentation TDD & Skill Writing FAQs

Question 1

What is Agent Search Optimization (ASO)?

Accepted Answer

ASO is a technique to help Claude find the right skill at the right time. It involves writing descriptions that focus on 'triggering conditions' and symptoms rather than summarizing the skill's workflow.

Question 2

What is a Claude Code Skill?

Accepted Answer

A Claude Code skill is a specialized reference guide that provides domain-specific guidance, patterns, and best practices to enhance Claude's behavior during complex tasks.

Question 3

How can I keep my skills token-efficient?

Accepted Answer

Focus on concise language, use cross-references instead of repeating content, move technical details to tool help commands, and target word counts between 150-500 words depending on the skill's usage frequency.

Question 4

When should I create a new skill versus updating CLAUDE.md?

Accepted Answer

Create a skill for reusable techniques, patterns, or tools that apply broadly across projects. Use CLAUDE.md for project-specific conventions and mechanical constraints.

Question 5

Why apply TDD to writing skills?

Accepted Answer

TDD ensures documentation actually works. By watching an agent fail without the skill and pass with it, you verify that the instructions are necessary, accurate, and correctly interpreted.

Documentation TDD & Skill Writing

Key Features

Use Cases

Documentation TDD & Skill Writing

Key Features

Use Cases