---
name: willoscar/source-tutorial-writer
source: https://app.decimal.ai/s/willoscar-source-tutorial-writer@1/SKILL.md
source_sha256: ac50b83e82ef
---

# Source Tutorial Writer

Writes the final tutorial markdown from approved module packs and the locked C2 structure.

## Inputs

- `outline/tutorial_context_packs.jsonl`
- `outline/module_plan.yml`
- `DECISIONS.md`

## Output

- `output/TUTORIAL.md`

## Contract

The tutorial must:
- start with reader orientation
- follow the approved module order
- keep per-module teaching sections explicit
- keep source notes visible but lightweight

Per module, the writer should emit:
- `### Why it matters`
- `### Key idea`
- `### Worked example`
- `### Check yourself`
- `### Source notes`

## Script boundary

`scripts/run.py` should:
- block on missing `Approve C2`
- load module packs in approved order
- render the deterministic tutorial scaffold/content into `output/TUTORIAL.md`

Keep rendering and pack interpretation in shared tutorial tooling, not in the wrapper.

## Acceptance

- `output/TUTORIAL.md` exists
- the required reader-orientation sections exist
- every module includes the required teaching subsections

## Non-goals

- self-loop QA reporting
- article/slides compilation