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
  1. Tools. Run node scripts/rendering-slides.mjs setup --status. If anything is missing, ask the person to run node scripts/rendering-slides.mjs setup once, 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 run sudo yourself.
  2. 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.md must say theme: deck in its front matter. To change the look later, run theme again.
  3. Render. Run node scripts/rendering-slides.mjs render --deck <folder>. It writes dist/deck.html (to present from, and the accessible version), dist/deck.pdf (tagged, with an outline), and dist/deck-notes.md (the speaker-notes script). Add --pptx only when the person asks for PowerPoint, and say it is made of slide pictures, so it is neither editable nor accessible. Add --images for PNG slide images.
  4. Look. Render with --images and 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, or media/), never dist/, and render again.
Installs
1
Repository
ken-guru/skills
GitHub Stars
1
First Seen
1 day ago