Skill Authoring & Documentation TDD FAQs

Question 1

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

Accepted Answer

Use skills for reusable techniques, patterns, or tools that apply across projects. Use CLAUDE.md for project-specific conventions and local environment details.

Question 2

What is the recommended file structure for a Claude Skill?

Accepted Answer

Skills should live in a dedicated directory with a SKILL.md file containing YAML frontmatter (name and description) and structured markdown content.

Question 3

How do I make my Claude skills easier to find?

Accepted Answer

Use Claude Search Optimization (CSO) by starting descriptions with 'Use when...', focusing on triggering conditions/symptoms rather than summarizing the workflow.

Question 4

Why is token efficiency important for skills?

Accepted Answer

Frequently referenced skills are loaded into the conversation context. Keeping them under 150-200 words ensures you have more space for actual coding and problem-solving.

Question 5

What does it mean to apply TDD to documentation?

Accepted Answer

It means writing a 'test case' (a scenario where an agent fails a task), creating the documentation (the skill), and then verifying the agent passes the scenario once it has access to the skill.

Skill Authoring & Documentation TDD

주요 기능

사용 사례

Skill Authoring & Documentation TDD

주요 기능

사용 사례