spec-distillerlisted
Install: claude install-skill alikmlsipahi/youtube-to-spec
# spec-distiller
Skill 2 of the YouTube intelligence pipeline — a **consumption-layer** analysis.
It reads the lossless artifacts produced by `youtube-artifact-collector` (Skill 1)
and produces a **Module → Feature → Requirement** document. It never touches
YouTube; the only input is artifact JSON, and the only coupling to Skill 1 is the
artifact's `schema_version` (read defensively).
## When to use this skill
Use it when the request is to **analyze already-collected artifacts**:
- "Extract the requirements from this artifact."
- "What features and business rules does this video/collection demonstrate?"
- "Build a requirements/spec document from this collection."
If the user instead wants to *collect* metadata/transcripts from URLs or a
playlist, that is Skill 1 (`youtube-artifact-collector`), not this skill.
## Engines
This skill ships two interchangeable engines that **emit the same output shape**:
- **`claude` (default, offline)** — no script runs. You (Claude) read the artifact
and the external prompt/template files in-chat and produce the document. No API
key required.
- **`openai`** — runs `scripts/extract_requirements.py`, which calls the OpenAI
API. Selected with `--engine openai`; needs `OPENAI_API_KEY` (see
`.env.example`).
The prompts and template are **external and swappable** — editing them changes the
output for *both* engines without any code change.
## Inputs
Either:
- a single artifact file — an artifact `.json` produced by Skill 1 (named