pitch-deck-builder

v1.0.0 MIT business updated 2026-09-27

Turn a JSON slide outline into a branded 16:9 HTML slide deck — one section per slide, arrow-key navigation, and a print stylesheet so every slide prints as its own page. Use when you need a quick, portable pitch deck without opening presentation software.

$ skillbank install pitch-deck-builder@1.0.0
# pins exactly 1.0.0 · README + changelog included

Pitch Deck Builder

Overview

You write your slides in a JSON outline — a title, an optional body, and a bullet list per slide — and scripts/deck.py builds a branded 16:9 HTML deck: one <section> per slide, a branded cover slide first, a tiny bit of JavaScript so arrow keys / space / PageUp / PageDown move through it, and a print stylesheet that lays each slide out on its own page. One file, no presentation software, no dependencies beyond Python itself.

Installation

1. Copy the pitch-deck-builder/ directory anywhere convenient. 2. Make the script executable (Unix):


   chmod +x scripts/deck.py

No pip install needed — standard library only.

Configuration

Two JSON files. See references/outline-schema.md for the full field list.

outline.json — the deck:


{
  "title": "Pawsitive Steps — Seed Pitch",
  "slides": [
    {"kind": "cover", "title": "Pawsitive Steps",
     "body": "A neighborhood dog-walking service with live GPS tracking."},
    {"title": "The problem",
     "bullets": [
       "70% of local dog owners work 9-to-5 with no midday relief",
       "Existing apps feel impersonal — no consistent walker"
     ]},
    {"title": "What we do",
     "bullets": ["Same walker every day", "Live GPS map plus a photo after every walk"]}
  ]
}

brand.json — your brand kit (same shape as the sibling skills):


{
  "business_name": "Pawsitive Steps",
  "colors": {"primary": "#1e5631", "accent": "#8fce62"}
}

The first slide, or any slide with "kind": "cover", renders with your primary color as the background. Colors are optional — missing entries fall back to neutral defaults, so {"business_name": "My Co"} works on its own. The outline must contain a non-empty slides list; slides with no title get an empty heading (say what you mean on each slide).

Inputs

scripts/deck.py --outline <outline.json> --brand <brand.json> --out <deck.html>

| Flag | Required | Description | |-------------|----------|-----------------------------------------------| | --outline | yes | Path to the outline JSON file. | | --brand | yes | Path to the brand JSON file. | | --out | yes | Path to write the HTML deck to. |

The script validates both files exist and parse as JSON before doing any work, and exits nonzero with a plain-English message (no tracebacks) if the outline has no slides or a slide is malformed. All text is HTML-escaped. Keyboard nav: →/space/PageDown forward, ←/PageUp back, Home/End jump.

Worked example


$ ./scripts/deck.py \
    --outline references/sample-outline.json \
    --brand references/sample-brand.json \
    --out deck.html
wrote deck.html (5 slides)

$ grep -c '<section' deck.html
5

$ grep -o "addEventListener('keydown'" deck.html
addEventListener('keydown'

The sample outline is a 5-slide seed pitch for a dog-walking business (cover, problem, what we do, plan, ask). Open deck.html in a browser and click through with the arrow keys; print to PDF and each slide lands on its own page.

Safety notes

This skill is a local document generator: it reads two JSON files and writes one HTML file. It never uploads anything, never makes network calls, and never runs remote commands. The deck opens best in a real browser — don't trust a headless screenshot for your final check.

Version history

1.0.0 — 2026-09-27

  • Initial release: scripts/deck.py builds a branded 16:9 HTML slide deck
  • (one <section> per slide, arrow-key navigation, print stylesheet) from --outline + --brand JSON.

  • First slide or "kind": "cover" slides render with the primary brand
  • color background.

  • Missing files, invalid JSON, and empty/malformed slide lists exit
  • nonzero with a plain error message; all text HTML-escaped.

← back to catalog