/Presentation

name: Presentation
metadata:
  short-description: "Makes talks and slide decks, either a read-aloud lecture built in Keynote or HTML or a cue-card HTML deck served with speaker view."
version: 1.3.1
description: "Makes talks, slide decks and sales pitches: a read-aloud lecture in Keynote or HTML, a cue-card HTML deck, or a pitch from product docs (value story, talking points, charcoal sketch). USE WHEN presentation, make me a deck, slides, slide deck, present on, give a talk on, keynote, speaker notes, present this, serve the deck, presenter mode, lecture, read-aloud talk, script for a talk, turn this essay or dictation into a talk, move this slide, reprocess the talk file, make that slide a diagram, find footage of the films I mention, make the animations autoplay, real book cover, real screenshot, too much white space, image too small, export to PPTX, sales pitch, sales narrative, sales deck, pitch deck, sales package, sales script, sales materials, product pitch, create a sales story, visual for this sales story, elevator pitch, value proposition, turn this into a pitch. NOT FOR images (Art), video (HyperFrames), web design (Webdesign), voice reading (ReadIt)."
evals:
  deterministic:
    - command: "bun skills/Presentation/Tools/Build.ts --self-test"
      falsifier: "exits nonzero when a slide with 0 or 6+ sentences, two sentences on one line, a sentence over 20 words, or an unknown TYPE passes validation, or when notes stop rendering one spaced paragraph per sentence, or when an art slide's CITE stops rendering as the bottom-left source line or pictures lose their 12 px rounded corners"
    - command: "bun skills/Presentation/Tools/Keynote.ts --self-test"
      falsifier: "exits nonzero when a design that drops, repeats or over-packs sentences validates, when an unchanged section is selected for redesign or an edited one is not, when a changed spoken word survives the notes diff, when --move loses or alters a section, when --set touches more than one field, or when an edited section does not find its earlier design, or when a Markdown heading does not start its own talking point titled with that heading, or a rewrite of a headed file loses a heading, or when a media slide whose subtitle is a credit line validates or --set source fails to write, or when a GIF repeated on any two slides or a still repeated with slides between passes as not a duplicate"
    - command: "bun skills/Presentation/Tools/KeynoteAutoplay.ts --self-test"
      falsifier: "exits nonzero when a movie-start build chunk does not read back automatic after patching, when a chunk for any other build is touched, when a patched .iwa payload does not round-trip, or when a second pass changes anything"
    - command: "bun skills/Presentation/Tools/KeynotePlayback.ts --self-test"
      falsifier: "exits nonzero when a slide whose animation step is not automatic in Keynote's export is reported clean, when a patched GIF slide or a slide whose only manual step is the final advance is reported stuck"
    - command: "bun skills/Presentation/Tools/Layout.ts --self-test"
      falsifier: "exits nonzero when art padded around a narrow drawing is allowed to bleed, when a slide with a bare half passes the pixel gate or a filled one fails it, when a book cover is not laid out standing beside its title, when split bullets are not centred on their picture, when a thumbnail-sized picture, an empty band over 30% of the slide body, a picture over text, or text in the footer passes the layout check, or when generated art keeps its paper margins, or when a real-thing still loses its transparent 12 pt corners or a GIF loses frames or its ground-coloured corners, or when one screen shown under two titles passes the look-alike check or a different screen fails it"
    - command: "bun skills/Presentation/Tools/RealThings.ts --self-test"
      falsifier: "exits nonzero when a slide whose sentences name a registered real thing keeps generated art instead of the registered picture, when a stage note in parentheses triggers it, or when a second pass changes anything"
    - command: "bun skills/Presentation/Tools/DeckCheck.ts --self-test"
      falsifier: "exits nonzero when a deck slide naming a registered real thing without its picture, a fragment build, a video without data-autoplay, a missing image, a thumbnail picture, a picture over text, overflow or a large empty band passes, or when a clean balanced slide is flagged"
    - command: "bun skills/Presentation/Tools/KeynoteMedia.ts --self-test"
      falsifier: "exits nonzero when a clip window over the length limit is accepted without --long, or when a valid window is refused"
    - command: "bun skills/Presentation/Tools/KeynoteArt.ts --self-test"
      falsifier: "exits nonzero when a diagram slide routes to any Art intent but TechnicalDiagrams or an essay slide to any but Essay, when a slide that already has an image is drawn again, or when a prompt carries the slide title or a title block"
  manual:
    reason: "whether the talk sounds like the speaker and the visuals support it needs the speaker presenting the rendered deck; the speaker view needs a real S keypress"
    falsifier: "the speaker stumbles reading a slide's notes aloud, a visual pulls attention away from what is being said, or a deck-mode slide carries more than one claim"

Presentation

**Contents:** Ideal State · Intent Routing · Data & Config · Gotchas · Examples

Talks, the slides behind them, and sales pitches, in three modes.

• **Lecture mode** is a talk the speaker reads aloud from start to finish. The text is the content and the slides are there for pacing: a new slide every 15 to 30 seconds keeps the room watching, and each visual either supports the sentence being read or stays quiet. The source is a talk file (READ.md or SCRIPT.md); the deck is Keynote or HTML and is regenerated from it.
• **Deck mode** is a deck where the slides carry the argument and the speaker glances at short cues. One claim per sl