skill-structure
Installation
SKILL.md
Contains Shell Commands
This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.
Skill Structure
Commands and Skills Are Merged
Custom slash commands and skills are the same thing. A file at .claude/commands/review.md and a skill at .claude/skills/review/SKILL.md both create /review. Existing .claude/commands/ files keep working. Skills add: a directory for supporting files, frontmatter to control invocation, and automatic context loading.
If a skill and command share the same name, the skill takes precedence.
When to use which:
| Type | When |
|---|---|
Command file (commands/name.md) |
Simple single-file workflow, no supporting files |
Skill directory (skills/name/SKILL.md) |
Needs references, background knowledge, or progressive disclosure |