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

Naming Rules

Related skills
Installs
36
GitHub Stars
39
First Seen
Feb 5, 2026