Skill Architect FAQs

Question 1

When should I include a script in my skill?

Accepted Answer

Include scripts in the /scripts folder when a task requires deterministic reliability, is repeatedly performed, or involves code that is fragile and error-prone when generated from scratch.

Question 2

What is a Claude Code Skill?

Accepted Answer

A skill is a modular, self-contained package that extends Claude's capabilities by providing specialized knowledge, tool integrations, and procedural workflows for specific domains.

Question 3

What is the anatomy of a SKILL.md file?

Accepted Answer

A SKILL.md file must contain YAML frontmatter with a name and description, followed by Markdown instructions that provide the core logic and workflow guidance for the skill.

Question 4

How do I optimize a skill for the context window?

Accepted Answer

Use the Progressive Disclosure principle: keep the SKILL.md lean and move detailed documentation or large schemas into separate reference files that Claude only loads when necessary.

Question 5

What is the difference between References and Assets?

Accepted Answer

References are documentation files intended for Claude to read and process, while Assets are files (like logos or templates) intended to be used directly in Claude's output without being loaded into context.

Skill Architect

Key Features

Use Cases

Skill Architect

Key Features

Use Cases