Claude Code Skill Authoring FAQs

Question 1

When should I use a Skill instead of CLAUDE.md?

Accepted Answer

Use Skills for complex methodologies, detailed references, and domain-specific knowledge. Use CLAUDE.md for universal project context that must be loaded every session.

Question 2

What is a Claude Code Skill?

Accepted Answer

A skill is on-demand reference material that Claude loads only when relevant to the current task, rather than every session, which helps keep the context window focused and efficient.

Question 3

What is progressive disclosure in skill authoring?

Accepted Answer

Progressive disclosure involves keeping the main SKILL.md file under 500 lines for high-level principles and linking to separate files like reference.md or examples.md for deeper technical details.

Question 4

Can I bundle scripts with my Claude Code Skill?

Accepted Answer

Yes, you can include a scripts/ directory to bundle utilities or deterministic computations that the skill might need to perform during execution.

Question 5

How does Claude discover my custom skill?

Accepted Answer

Claude uses the 'description' field in the skill's frontmatter to drive automatic discovery. Including keywords that users would naturally say helps Claude trigger the skill when needed.

Claude Code Skill Authoring

主要功能

使用场景

Claude Code Skill Authoring

主要功能

使用场景