skill-creator-multi

# Multi-Phase Skill Creator

Create skills that execute multiple phases in sequence, where each phase builds on the previous phase's output.

## When to Use Multi-Phase Skills

Multi-phase skills are appropriate when:
- A task naturally decomposes into distinct sequential stages
- Each stage transforms or filters the previous stage's output
- Separating concerns improves reliability and debuggability
- The same pipeline applies to different inputs

Examples: gap analysis, code review pipelines, document processing chains.

## Multi-Phase Skill Structure

```
skill-name/
├── start-skill-name/SKILL.md   # Orchestrator (invokes phases in order)
├── skill-name-1/SKILL.md       # Phase 1 (raw collection/identification)
├── skill-name-2/SKILL.md       # Phase 2 (analysis/filtering)
└── skill-name-3/SKILL.md       # Phase 3 (refinement/final output)
```

### Orchestrator Pattern (start-*)

The `start-*` skill defines the sequence and ensures all phases run without stopping:

```yaml
---
name: start-skill-name
description: [What it does]. Use when user explicitly asks start-skill-name.
---
```

Body lists procedure steps and includes:
```
**IMPORTANT:** Do NOT stop between steps. Run all steps skill-name-* in a single turn.
```

### Phase Pattern (skill-name-N)

Each phase skill:
- Has description: `Triggered by start-skill-name.`
- Defines specific task, rules, output format, anti-patterns
- References previous step's output in conversation context

## Creation Process

### Step 1: Design the Pipeline

Define phases before creating files:
1. What does each phase do?
2. What is the input/output format for each phase?
3. What rules constrain each phase?

### Step 2: Initialize with Script

```bash
scripts/init_multi_skill.py <skill-name> --path <output-dir> [--phases N]
```

Examples:
```bash
# Default 3 phases
scripts/init_multi_skill.py code-reviewer --path skills/public

# Custom 4 phases
scripts/init_multi_skill.py doc-analyzer --path skills/private --phases 4
```

### S