1.1The Two-Part Structure

Every skill is a single markdown file with YAML frontmatter and markdown body:

┌─────────────────────────────┐
│  ---                        │  ← YAML frontmatter start
│  name: my-skill             │
│  description: ...           │  ← Metadata (selection signal)
│  allowed-tools: Bash,Read   │
│  ---                        │  ← YAML frontmatter end
│                             │
│  # Instructions             │
│  Step 1: Do this...         │  ← Markdown body (execution instructions)
│  Step 2: Then this...       │
└─────────────────────────────┘