# Source Tutorial Writer

> Use when approved tutorial context packs exist and the run needs the final article-first tutorial deliverable.

- Skill: `willoscar/source-tutorial-writer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add willoscar/source-tutorial-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/willoscar/source-tutorial-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: WILLOSCAR (https://skillmd.com/u/willoscar)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/willoscar/source-tutorial-writer

---


# Source Tutorial Writer

## Triggers & routing

- **Trigger**: source tutorial writer, tutorial drafting, 教程正文, 从资料写教程.
- **Use when**: `source-tutorial` 的 C3，`outline/tutorial_context_packs.jsonl` 已就绪，且 `DECISIONS.md` 已勾选 `Approve C2`。
- **Skip if**: C2 未批准，或 context packs 还没准备好。
- **Network**: none.
- **Guardrail**: 正文必须 reader-first，但不能写出 sources 没支持的内容。


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