Skill Authoring & TDD Documentation FAQs

Question 1

What is the core difference between a skill and project documentation?

Accepted Answer

Skills are reusable techniques or patterns that apply broadly across projects, whereas project-specific conventions should be placed in a CLAUDE.md file.

Question 2

How do I make my skills discoverable by Claude?

Accepted Answer

Use the Claude Search Optimization (CSO) patterns, specifically focusing on 'Use when' triggers in the description field and avoiding workflow summaries that Claude might follow instead of reading the full skill.

Question 3

Where should I store my personal Claude skills?

Accepted Answer

Personal skills should be stored in agent-specific directories such as ~/.claude/skills for Claude Code or ~/.agents/skills/ for Codex.

Question 4

Why apply TDD to writing documentation?

Accepted Answer

Using TDD ensures the skill is necessary and effective; by watching an agent fail without the skill (Red) and pass with it (Green), you confirm the documentation actually drives the intended behavior.

Question 5

What is a Claude Code Skill?

Accepted Answer

A skill is a specialized reference guide for proven techniques, patterns, or tools that enhances Claude's behavior when performing specific domain-specific tasks.

Skill Authoring & TDD Documentation

Key Features

Use Cases

Skill Authoring & TDD Documentation

Key Features

Use Cases