slide-ai-kit

Themed PowerPoint decks from a declarative spec, made for AI agents (and people who script).

  • 17 fixed-grid templates: cover, section, bullets, cards, KPIs, goal, table, timeline, flow, stack, two-column, tracks, Gantt, two-plane architecture, screenshot + notes, hero shot, closing.
  • Themes hold every brand decision: colours, fonts, logos, footer. Decks never hard-code styling.
  • Validator rejects overflowing or malformed slides before anything is written.
  • Render-to-PDF self-check (LibreOffice) so an agent can look at what it built.
  • One dependency: pptxgenjs.
Default theme Branded theme (Nodus)
Default theme Nodus theme
Neutral slate + blue, the brand name drawn as text Logo mark + wordmark, brand colours

Install

npm i -g github:sparklabx/slide-ai-kit     # CLI: slide-ai
# or as a project dependency
npm i github:sparklabx/slide-ai-kit

Rendering to PDF needs LibreOffice (soffice on PATH, or set SOFFICE).

Use

import { buildDeck } from "slide-ai-kit";
import theme from "slide-ai-kit/themes/default";

await buildDeck([
  { t: "title", title: "Quarterly review", subtitle: "Engineering", meta: "Q3 2026" },
  { t: "bullets", title: "Highlights", items: [
    { h: "Shipped:", t: " the new billing flow" },
    "Halved build times",
  ] },
  { t: "kpi", title: "Numbers", kpis: [{ value: "99.95%", label: "Uptime" }, { value: "-48%", label: "Build time" }] },
  { t: "closing", title: "Thank you", contact: "team@example.com" },
], "/abs/path/review.pptx", { theme });
slide-ai render review.pptx   # → review.pdf
slide-ai templates            # every template's fields and limits
npm run demo                  # out/demo-default.pptx and out/demo-nodus.pptx: every template, both themes

Make a theme

Copy themes/default/theme.mjs and edit it:

export default {
  name: "Acme",                       // drawn as text when there is no logo
  footer: "Acme — Confidential",
  colors: { dark: "0B1F3A", primary: "E4572E", accent: "F3A712", ink: "1F2937", /* … */ },
  ramp: ["0B1F3A", "E4572E"],         // what cards/steps cycle through (must read with white text)
  fonts: { head: "Montserrat", body: "Arial" },
  logos: {                            // PNGs; aspect = width / height
    word:      { path: "/abs/acme-wordmark.png",       aspect: 3.5 },   // light slides
    wordWhite: { path: "/abs/acme-wordmark-white.png", aspect: 3.5 },   // dark slides
    mark:      { path: "/abs/acme-mark.png",           aspect: 1 },
    markWhite: { path: "/abs/acme-mark-white.png",     aspect: 1 },
  },
  brand: { mark: true, sectionLogo: false },   // mark + wordmark on cover/closing; no logo on section slides
};

See themes/nodus/ for a complete branded theme.

For AI agents

skills/slide-ai/SKILL.md is a ready-made skill (Claude Code and compatible agents): copy or symlink it into your agent’s skills folder. slide-ai workflow prints the build loop with absolute import paths.

License

Apache-2.0. The Nodus logos in themes/nodus/assets/ belong to the Nodus project and are included only as a theme example.

Source: README.md on GitHub ↗