rendering-slides
Installation
SKILL.md
Rendering slides
Turn a Deck Folder's deck.md into the Rendered Deck, in the deck's theme, and prove the result is readable and accessible.
Script paths below are relative to this skill's folder. Run each as one command with the folder's absolute path in front, never chained with &&, $(…), or heredocs. The Deck Folder layout is in references/deck-folder.md.
Workflow
- [ ] 1. Tools installed
- [ ] 2. Theme in place
- [ ] 3. Rendered
- [ ] 4. Slides looked at
- Tools. Run
node scripts/rendering-slides.mjs setup --status. If anything is missing, ask the person to runnode scripts/rendering-slides.mjs setuponce, outside the sandbox: it installs a pinned Marp CLI and browser with verified checksums into a shared cache. On Linux it may print one package-install command for the person to run; never runsudoyourself. - Theme. If the Deck Folder has no
theme.css, apply the look from the Brief:node scripts/rendering-slides.mjs theme --deck <folder> --name editorial(light) or--name editorial-inverse(dark), or a brand theme with--brand <brand.json>(see references/themes.md).deck.mdmust saytheme: deckin its front matter. To change the look later, runthemeagain. - Render. Run
node scripts/rendering-slides.mjs render --deck <folder>. It writesdist/deck.html(to present from, and the accessible version),dist/deck.pdf(tagged, with an outline), anddist/deck-notes.md(the speaker-notes script). Add--pptxonly when the person asks for PowerPoint, and say it is made of slide pictures, so it is neither editable nor accessible. Add--imagesfor PNG slide images. - Look. Render with
--imagesand look at every slide: text overflowing its slot, overlapping elements, unreadable contrast, a visual that misses its caption. Fix the source (deck.md,theme.css, ormedia/), neverdist/, and render again.