pitch-deck-builder
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.pybuilds a branded 16:9 HTML slide deck - First slide or
"kind": "cover"slides render with the primary brand - Missing files, invalid JSON, and empty/malformed slide lists exit
(one <section> per slide, arrow-key navigation, print stylesheet) from --outline + --brand JSON.
color background.
nonzero with a plain error message; all text HTML-escaped.