Shipyard Skill Authoring FAQs

Question 1

Why use TDD for writing documentation?

Accepted Answer

Using Test-Driven Development for skills ensures the documentation actually works. By watching an agent fail without the skill (Red) and pass with it (Green), you verify the skill teaches the correct behavior.

Question 2

What is the 'workflow summary' trap in skill descriptions?

Accepted Answer

If a skill description summarizes the internal workflow, Claude may follow the summary instead of reading the full skill content. Descriptions should focus only on 'when' to use the skill to ensure Claude reads the full instructions.

Question 3

What is a Claude Code Skill?

Accepted Answer

A Claude Code Skill is a specialized capability file (SKILL.md) that provides domain-specific guidance, best practices, and implementation patterns to enhance Claude's behavior during specific tasks.

Question 4

How does this help with token efficiency?

Accepted Answer

The skill provides patterns for compressing examples, using cross-references effectively, and moving heavy reference material to secondary files to keep the main context window clear.

Question 5

What is Claude Search Optimization (CSO)?

Accepted Answer

CSO is the practice of structuring skill names, descriptions, and keywords specifically so that Claude can accurately identify and load the most relevant skills for any given natural language request.

Shipyard Skill Authoring

主な機能

ユースケース

Shipyard Skill Authoring

主な機能

ユースケース