Claude Skill Writing TDD FAQs

Question 1

How do I optimize skills for Claude's search discovery?

Accepted Answer

Use the 'Use when...' pattern in descriptions, focus on symptoms and triggering conditions, and avoid summarizing the workflow in the description field to force Claude to read the full skill content.

Question 2

What is a Claude Code Skill?

Accepted Answer

A Claude Code Skill is a specialized reference guide (SKILL.md) stored in your local directory that provides domain-specific patterns and tools to help Claude perform tasks more effectively.

Question 3

Where are these skills stored?

Accepted Answer

Personal skills are typically stored in the ~/.claude/skills directory for Claude Code or ~/.agents/skills/ for Codex environments.

Question 4

Why apply TDD to documentation?

Accepted Answer

TDD ensures a skill is actually effective. By watching Claude fail a task without the skill (Red), then pass after the skill is added (Green), you prove the documentation actually changes agent behavior.

Question 5

What is the recommended structure for a skill?

Accepted Answer

A skill should follow a standardized SKILL.md format including YAML frontmatter, an overview, 'When to Use' triggers, core patterns, and common mistakes.

Claude Skill Writing TDD

主要功能

使用场景

Claude Skill Writing TDD

主要功能

使用场景