beamer-scaffold

Beamer Scaffold

Triggers & routing

• Trigger: beamer scaffold, slides from tutorial, tutorial slides, generate beamer, tutorial slides.
• Use when: source-tutorial C4, need to convert output/TUTORIAL.md into compilable latex/slides/main.tex。
• Skip if: there is no tutorial body yet.
• Network: none.
• Guardrail: slides cannot be just a mechanical heading dump; must maintain module alignment and be suitable for teaching/light self-study.

Goal: produce a compile-ready Beamer deck from the final tutorial.

output/TUTORIAL.md is the canonical prose input, while outline/module_plan.yml keeps the slide deck aligned with the approved module order.

Inputs

• output/TUTORIAL.md
• outline/module_plan.yml

Outputs

• latex/slides/main.tex

Script

Quick Start

• uv run python .codex/skills/beamer-scaffold/scripts/run.py --workspace <workspace>

All Options

• --workspace <dir> (required)
• --unit-id <U###>
• --inputs <semicolon-separated>
• --outputs <semicolon-separated>
• --checkpoint <C#>

Examples

• Build latex/slides/main.tex from the tutorial:
  • uv run python .codex/skills/beamer-scaffold/scripts/run.py --workspace <workspace>