← All runbooks
adewale / slide-maker

slide-maker

Generate presentation decks grounded in real GitHub projects, or walk through a structured brief-to-slides process. This skill supports creating and updating native Slidev deck projects — complete with a compiled `slides.md`, a `deck.spec.md` specification, and a project `README.

agent claude-codemodel claude-sonnet-4-6snapshot python312-uveval programmatic12 stepsv1.0.0

Deploy slide-maker to your jetty.io

One-click installs this runbook into a collection on your Jetty account. You can run it from the Spot dashboard, schedule it, or pipe inputs in via the API.

Deploy on jetty.io →View source
The shape of the run

12 steps · start to finish.

  1. 1
    Step 1

    Environment Setup

    ▶

    Verify the environment and install required dependencies.

    # Check Node.js and npm
command -v node >/dev/null || { echo "ERROR: Node.js not installed"; exit 1; }
command -v npm  >/dev/null || { echo "ERROR: npm not installed"; exit 1; }

# Install Slidev CLI if not present
npm list -g @slidev/cli 2>/dev/null || npm install -g @slidev/cli

# Create output directory
mkdir -p /app/results/styles

# Verify required inputs are provided
if [ -z "$GOAL" ]; then
  echo "ERROR: GOAL (goal or update instructions) is not set"
  exit 1
fi
echo "Environment setup complete. Mode: ${MODE:-create}"

    Load reference documents only when entering the relevant phase. Do not load all files upfront.

    PhaseLoad these filesPurpose
    1. Determine mode(none)—
    2. Gather sourcesSOURCES.md (project decks only)Source-material lookup, extraction heuristics, through-line, project identity
    3. IntakePRESENTATION_PHILOSOPHY.md, STORYTELLING.mdRhetorical principles, narrative structure, through-line design
    4. Style directionSTYLE_PRESETS.mdVisual presets and token palettes
    5. Write specDECK_SPEC.md, SLIDE_KINDS.mdSpec schema and slide type catalog
    6. CompileCOMPILER_RULES.md, SLIDEV_REFERENCE.mdCompilation phases, Slidev features
    7. ValidateACCEPTANCE_CHECKLIST.md, LLM_TELLS.mdQuality gates
    8. Deliver(none)—
  2. 2
    Step 2

    Determine Mode

    ▶

    Identify whether this is a **create** or **update** run.

  3. 3
    Step 3

    Gather Source Material (project decks only)

    ▶

    > Load `SOURCES.md` at this phase (project decks only).

  4. 4
    Step 4

    Intake — Narrative Principles

    ▶

    > Load `PRESENTATION_PHILOSOPHY.md` and `STORYTELLING.md` at this phase.

  5. 5
    Step 5

    Style Direction

    ▶

    > Load `STYLE_PRESETS.md` at this phase.

  6. 6
    Step 6

    Write or Revise `deck.spec.md`

    ▶

    > Load `DECK_SPEC.md` and `SLIDE_KINDS.md` at this phase.

  7. 7
    Step 7

    Compile the Deck

    ▶

    > Load `COMPILER_RULES.md` and `SLIDEV_REFERENCE.md` at this phase.

  8. 8
    Step 8

    Iterate on Errors (max 3 rounds)

    ▶

    If Step 6 validation or Step 7 compilation fails:

  9. 9
    Step 9

    Validate

    ▶

    > Load `ACCEPTANCE_CHECKLIST.md` and `LLM_TELLS.md` at this phase.

  10. 10
    Step 10

    Deliver

    ▶

    Write the final deliverables to `/app/results/`: - `deck.spec.md` — approved spec - `slides.md` — compiled Slidev slides - `README.md` — project README with deck title, through-line, how to run, slide count, preset used

  11. 11
    Step 11

    Write Validation Report

    ▶

    Write `/app/results/validation_report.json` reflecting all stage outcomes.

  12. 12
    Step 12

    Write Executive Summary

    ▶

    Write `/app/results/summary.md` with run metadata, mode detected, through-line, slide count, preset used, validation results, and any issues.