mckinsey-deck

McKinsey-Style Deck (the style + engine skill)

Build a research-grade-looking, page-turning deck from content the user gives you. Reviewed on screen as an HTML presentation; shared as a print-clean PDF. The whole engine is one file — assets/deck_engine.py — copy it into the project and compose build().

This skill owns the canonical engine. mckinsey-market-research-deck (and any future deck skill) consumes assets/deck_engine.py from HERE — engine fixes land in this file only, never in a project-local or sibling-skill fork. One engine, zero drift.

How to use

1. Copy assets/deck_engine.py into the working dir. Set BRAND (the footer line) and OUT_HTML.
2. Compose the deck inside build() using the renderers (below). Feed them the user's content directly, or load from a JSON if the content is structured.
3. Render + export:

   python3 deck_engine.py
   "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu \
     --no-pdf-header-footer --print-to-pdf="Deck.pdf" "Deck.html"
   

   (Windows/Linux: swap the Chrome path for chrome/google-chrome.)
4. QC (below), fix, re-render, then deliver.

Renderers (all in deck_engine.py)

• cover(title_html, subtitle) — navy hero (uses product-images/cover-hero.png if present), title + one subtitle.
• answer_slide(title, deck, governing, pillars, src) — the executive-summary page (Pyramid Principle: answer first). One-sentence governing thought + 3–4 pillar conclusions, each optionally with a serif key stat. Place right after the cover; reading only the headlines from here to the end must form one persuasive essay (horizontal logic).
• divider(no, title, points) — full-navy section break; big sky-blue number; optional duotone image (divider-<no>.png).
• heroes([(num, label), ...]) — 4-up serif stat strip.
• prose_slide(title, deck, themes, src, cols=2, note=None) — "bold theme + paragraph" blocks (the McKinsey prose page). themes=[(heading, paragraph_html), ...].
• essay_slide(title, deck, lead, paras, src, side=None) — flowing two-column prose + optional side rail.
• table_slide(title, deck, columns, rows, src, note=None, fill=True, bold_keys=(), extra=None) — navy-header table, uniform row heights (header 34px / rows 52px, never stretched); bold_keys highlights total rows; extra= takes a content block (e.g. heroes([...])) to fill a sparse page by composition.
• decision_slide(page, src) — renders a structured exhibit (buildup/breakdown/scenarios + assumptions + READ).
• donut_block(...), bars_chart(...), heatmap_block(...) — titled chart blocks for a page's side rail (charts ride beside their analysis; never alone on a page); charts_slide(...) for the rare full-canvas exhibit. Low-level: donut_svg(...), heatmap hcell(...).
• sources_register(url_set, selected_rows, src) — the numbered, clickable source appendix.
• render(slides) — assembles the page-turning HTML and prints the div-balance check.