@aivorynet/slaide 1.0.0

package/dist/render-png/shoot.js

@@ -0,0 +1,79 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// @slaide/render-png — Playwright headless-Chromium capture of every slide to a
+// PNG, with all builds settled. This is the fast "see your deck" loop: authoring
+// a theme without it means flying blind (you can ship invisible text and never
+// know). Renders the same web runtime markup, so PNGs match what an audience sees.
+import { renderDeckHtml } from '../index.js';
+import { readFileSync, mkdirSync } from 'node:fs';
+import { dirname, resolve, join } from 'node:path';
+async function loadPlaywright() {
+    try {
+        return await import('playwright');
+    }
+    catch {
+        throw new Error('PNG export needs Playwright. Install it:\n' +
+            '  npm install playwright\n' +
+            '  npx playwright install chromium');
+    }
+}
+/** Render a self-contained web-deck HTML + its IR to per-slide PNGs (builds settled). */
+export async function shootHtml(html, ir, opts = {}) {
+    const outDir = opts.out ?? 'out/shots';
+    // Derive the missing dimension from the canvas aspect so `--width 512` yields a 16:9
+    // shot (not a portrait frame letterboxed top/bottom). Both unset → full canvas size.
+    const cw = ir.canvas.width;
+    const ch = ir.canvas.height;
+    let width = opts.width;
+    let height = opts.height;
+    if (width && !height)
+        height = Math.round((width * ch) / cw);
+    else if (height && !width)
+        width = Math.round((height * cw) / ch);
+    width = width ?? cw;
+    height = height ?? ch;
+    const scale = opts.scale ?? 1;
+    const tag = opts.tag ?? 'slide';
+    const fmt = opts.format ?? 'png';
+    const quality = Math.max(1, Math.min(100, opts.quality ?? 82));
+    mkdirSync(outDir, { recursive: true });
+    const { chromium } = await loadPlaywright();
+    const browser = opts.browser ?? (await chromium.launch());
+    try {
+        const page = await browser.newPage({ viewport: { width, height }, deviceScaleFactor: scale });
+        let doc = html;
+        if (opts.hideChrome) {
+            doc = doc.replace('</head>', '<style>.sl-counter,.sl-progress,.sl-notes,.sl-help,.sl-present-toggle{display:none !important;}</style></head>');
+        }
+        await page.setContent(doc, { waitUntil: 'networkidle' });
+        await page.evaluate(() => document.fonts?.ready);
+        // Render all charts (lazy in the runtime) and wait until they settle so every
+        // captured frame includes them. No-op + immediate for chart-free decks.
+        await page.evaluate(() => window.__slaideCharts?.renderAll());
+        await page
+            .waitForFunction(() => window.__slaideChartsReady === true, { timeout: 8000 })
+            .catch(() => { });
+        await page.waitForTimeout(400);
+        const paths = [];
+        for (let i = 0; i < ir.slides.length; i++) {
+            // window.slaide.show(n) reveals slide n with every build settled (shown).
+            await page.evaluate((n) => window.slaide.show(n), i);
+            await page.waitForTimeout(180);
+            const p = join(outDir, `${tag}-${String(i + 1).padStart(2, '0')}.${fmt === 'jpeg' ? 'jpg' : 'png'}`);
+            await page.screenshot(fmt === 'jpeg' ? { path: p, type: 'jpeg', quality } : { path: p });
+            paths.push(p);
+        }
+        return paths;
+    }
+    finally {
+        if (!opts.browser)
+            await browser.close();
+    }
+}
+/** Render every slide of a deck file to <out>/<tag>-NN.png. Returns the file paths. */
+export async function shootDeck(deckPath, opts = {}) {
+    const src = readFileSync(deckPath, 'utf8');
+    const { html, ir } = renderDeckHtml(src, dirname(resolve(deckPath)), { mode: 'web', inline: true });
+    return shootHtml(html, ir, opts);
+}
+//# sourceMappingURL=shoot.js.map

package/dist/render-png/shoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shoot.js","sourceRoot":"","sources":["../../src/render-png/shoot.ts"],"names":[],"mappings":"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"}

package/dist/scaffold.d.ts

@@ -0,0 +1,9 @@
+export interface ScaffoldOptions {
+    title: string;
+    subtitle?: string;
+    /** Section/slide titles to stub out. */
+    outline?: string[];
+    /** Master reference; omit to use the bundled default theme. */
+    master?: string;
+}
+export declare function scaffoldDeck(opts: ScaffoldOptions): string;

package/dist/scaffold.js

@@ -0,0 +1,36 @@
+export function scaffoldDeck(opts) {
+    const lines = [];
+    lines.push('---');
+    if (opts.master)
+        lines.push(`master: ${opts.master}`);
+    lines.push(`title: ${opts.title}`);
+    lines.push('~transition: slide-left');
+    lines.push('---');
+    lines.push('layout: cover');
+    lines.push('---');
+    lines.push(':: title ::');
+    lines.push(opts.title);
+    lines.push(':: subtitle ::');
+    lines.push(opts.subtitle ?? 'A presentation written in slaide');
+    lines.push('');
+    lines.push('??? Speaker notes for the opening slide.');
+    for (const item of opts.outline ?? ['Overview', 'Details', 'Summary']) {
+        lines.push('');
+        lines.push('---');
+        lines.push('layout: title-content');
+        lines.push('---');
+        lines.push(`## ${item}`);
+        lines.push('');
+        lines.push('- First point   >>>');
+        lines.push('- Second point  >>>');
+        lines.push('- Third point   >>>');
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push('layout: section');
+    lines.push('---');
+    lines.push('# Thank you');
+    lines.push('');
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,YAAY,CAAC,IAAqB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,IAAI,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,kCAAkC,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAEvD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,212 @@
+export declare const SCHEMA_VERSION: "slaide/1";
+export interface Warning {
+    code: string;
+    message: string;
+    line?: number;
+}
+export interface ParsedRegion {
+    name: string;
+    /** Raw markdown (region marker stripped). Build/anchor sigils handled in compiler. */
+    markdown: string;
+}
+export interface ParsedSlide {
+    /** Per-slide config (scoped) merged with cascaded keys at compile time. */
+    frontmatter: Record<string, unknown>;
+    regions: ParsedRegion[];
+    notes: string | null;
+    sourceLine: number;
+}
+export interface ParsedDeck {
+    headmatter: Record<string, unknown>;
+    slides: ParsedSlide[];
+    warnings: Warning[];
+}
+export interface MasterFont {
+    family: string;
+    provider?: 'google' | 'local' | 'system';
+    weights?: number[];
+}
+export interface TypeScale {
+    base: string;
+    ratio: number;
+    steps: Record<string, number | string>;
+}
+export interface MasterColors {
+    palette: Record<string, string>;
+    roles: Record<string, string>;
+}
+export type BackgroundDef = {
+    type: 'solid';
+    color: string;
+} | {
+    type: 'gradient';
+    stops: string[];
+    angle?: number;
+} | {
+    type: 'image';
+    src: string;
+    fit?: 'cover' | 'contain';
+    dim?: number;
+};
+export interface SlotDef {
+    type: string;
+    style?: Record<string, string>;
+}
+export interface LayoutDef {
+    /** grid-template-areas rows, each a quoted string of area names. */
+    areas: string[];
+    rows?: string;
+    cols?: string;
+    background?: string;
+    variant?: string;
+    slots: Record<string, SlotDef>;
+    padding?: string;
+    gap?: string;
+    align?: string;
+    chrome?: boolean | string;
+    logo?: boolean;
+}
+export interface VariantDef {
+    roles?: Record<string, string>;
+    tokens?: Record<string, string>;
+}
+export interface ChromeBand {
+    left?: string;
+    center?: string;
+    right?: string;
+}
+export interface ChromeDef {
+    header?: ChromeBand;
+    footer?: ChromeBand;
+    /** Raw inline SVG or HTML for a logo mark. */
+    logo?: string;
+    /** Logo corner: top-left | top-right | bottom-left | bottom-right. */
+    logoPos?: string;
+}
+export interface Master {
+    schema?: string;
+    name: string;
+    description?: string;
+    canvas?: {
+        aspect?: string;
+        width?: number;
+        height?: number;
+    };
+    fonts?: Record<string, MasterFont>;
+    typeScale?: TypeScale;
+    colors?: MasterColors;
+    /** Named gradients -> CSS gradient strings (used by `.grad` spans and slot styles). */
+    gradients?: Record<string, string>;
+    /** Raw CSS custom-property overrides merged into the deck tokens (e.g. spacing/chrome). */
+    tokens?: Record<string, string>;
+    backgrounds?: Record<string, BackgroundDef>;
+    layouts?: Record<string, LayoutDef>;
+    variants?: Record<string, VariantDef>;
+    transitions?: {
+        default?: string;
+        duration?: number;
+        ease?: string;
+    };
+    /** Theme-defined named animations (slide transitions and/or element entrances),
+     *  merged into the built-in catalog so authors/AI can reference them by name. */
+    animations?: Record<string, MasterAnimationDef>;
+    chrome?: ChromeDef;
+    /** Interactive-presentation UI toggles (web runtime only; never affects PDF/print). */
+    ui?: {
+        progress?: boolean;
+    };
+}
+export interface MasterAnimationDef {
+    /** slide transition: keyframe body for the entering slide, e.g. "from{…} to{…}". */
+    in?: string;
+    /** slide transition: keyframe body for the leaving slide. */
+    out?: string;
+    /** element entrance: pre-reveal hidden state, e.g. "opacity:0;transform:scale(.8)". */
+    hidden?: string;
+    /** force interpretation as an entrance (otherwise inferred from `hidden` vs `in`/`out`). */
+    entrance?: boolean;
+    duration?: number;
+    ease?: string;
+}
+export interface RegionIR {
+    name: string;
+    /** Original parsed region name in the source (`default` or a `:: marker ::`),
+     *  before routing to a layout slot — source-provenance for round-tripping the
+     *  rendered DOM back to its source region (the DOM `name` is the slot, which may
+     *  differ from the source name for the default region). */
+    source: string;
+    /** Rendered HTML, with build elements carrying data-build. */
+    html: string;
+    /** Style hints resolved from the slot definition. */
+    slotType: string;
+    style: Record<string, string>;
+}
+export interface SlideIR {
+    index: number;
+    layout: string;
+    transition: string;
+    background: BackgroundDef | null;
+    /** master-defined names for this slide (for editor round-tripping; null when unset). */
+    bgName?: string | null;
+    variantName?: string | null;
+    /** grid CSS for this slide's layout. */
+    grid: {
+        areas: string;
+        rows: string;
+        cols: string;
+        padding: string;
+        gap: string;
+        align: string;
+    };
+    regions: RegionIR[];
+    notes: string | null;
+    /** total number of build steps on this slide. */
+    buildCount: number;
+    morph: string | null;
+    /** per-slide CSS custom property overrides (from variants). */
+    vars: Record<string, string>;
+    /** resolved chrome (placeholders substituted, inline markdown rendered). */
+    chrome: ResolvedChrome | null;
+}
+export interface ResolvedChrome {
+    header: {
+        left: string;
+        center: string;
+        right: string;
+    } | null;
+    footer: {
+        left: string;
+        center: string;
+        right: string;
+    } | null;
+    logo: string | null;
+    logoPos: string;
+}
+export interface DeckIR {
+    schema: string;
+    meta: {
+        title: string | null;
+        author: string | null;
+    };
+    canvas: {
+        width: number;
+        height: number;
+        aspect: string;
+    };
+    /** flat CSS custom properties, e.g. "--color-text": "#fff". */
+    tokens: Record<string, string>;
+    /** font import directives (e.g. google fonts URL or @font-face css). */
+    fontImports: string[];
+    transitions: {
+        default: string;
+        duration: number;
+    };
+    /** CSS for master-defined custom animations (appended to the deck stylesheet). */
+    animCss: string;
+    /** Resolved interactive-UI toggles (web runtime only). */
+    ui: {
+        progress: boolean;
+    };
+    slides: SlideIR[];
+    warnings: Warning[];
+}

package/dist/types.js

@@ -0,0 +1,7 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Shared types for the slaide pipeline: parser AST and the compiled IR.
+// The IR (DeckIR) is the durable, renderer-agnostic contract. Bump SCHEMA_VERSION
+// only with a migration story (see plan: @slaide/migrate).
+export const SCHEMA_VERSION = 'slaide/1';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,sCAAsC;AACtC,wEAAwE;AACxE,kFAAkF;AAClF,2DAA2D;AAE3D,MAAM,CAAC,MAAM,cAAc,GAAG,UAAmB,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,6 @@
+/** Escape text for safe interpolation into HTML (text or double-quoted attrs). */
+export declare function escapeHtml(s: string): string;
+/** Serialize a CSS property map into a `prop:val;prop:val` string. */
+export declare function serializeStyle(style: Record<string, string>): string;
+/** Expand an anchor spec `"x y w h"` into absolute-position CSS properties. */
+export declare function expandAnchor(spec: string): Record<string, string>;

package/dist/util.js

@@ -0,0 +1,28 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Small shared helpers used across the pipeline.
+/** Escape text for safe interpolation into HTML (text or double-quoted attrs). */
+export function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+/** Serialize a CSS property map into a `prop:val;prop:val` string. */
+export function serializeStyle(style) {
+    return Object.entries(style)
+        .map(([k, v]) => `${k}:${v}`)
+        .join(';');
+}
+/** Expand an anchor spec `"x y w h"` into absolute-position CSS properties. */
+export function expandAnchor(spec) {
+    const [x, y, w, h] = spec.trim().split(/\s+/);
+    const out = { position: 'absolute' };
+    if (x)
+        out.left = x;
+    if (y)
+        out.top = y;
+    if (w)
+        out.width = w;
+    if (h)
+        out.height = h;
+    return out;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,sCAAsC;AACtC,iDAAiD;AAEjD,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtG,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,KAA6B;IAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,GAAG,GAA2B,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC7D,IAAI,CAAC;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IACpB,IAAI,CAAC;QAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IACrB,IAAI,CAAC;QAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@aivorynet/slaide",
+  "version": "1.0.0",
+  "description": "An AI-authorable slide language with beautiful web + PDF output",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Paul Piper",
+  "keywords": [
+    "slides",
+    "presentation",
+    "markdown",
+    "pdf",
+    "ai",
+    "deck",
+    "powerpoint-alternative"
+  ],
+  "bin": {
+    "slaide": "bin/slaide.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "themes",
+    "skills",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:engine": "bun build src/engine-entry.ts --compile --external playwright --external playwright-core --external chromium-bidi --outfile viewer/vendor/slaide-engine",
+    "build:viewer": "npm run build:engine && cargo build --release --manifest-path viewer/Cargo.toml",
+    "dev": "tsx src/cli.ts",
+    "slaide": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "fast-xml-parser": "^4.5.6",
+    "js-yaml": "^4.1.0",
+    "jszip": "^3.10.1",
+    "markdown-it": "^14.1.0",
+    "zod": "^3.24.1"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.49.0",
+    "pptxgenjs": "^3.12.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^22.10.0",
+    "@types/pngjs": "^6.0.5",
+    "pdf-to-png-converter": "^4.1.1",
+    "pixelmatch": "^7.2.0",
+    "pngjs": "^7.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}

package/skills/slaide/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: slaide
+description: Author and render slaide presentations — a Markdown + YAML slide language that exports a web deck, a high-fidelity PDF, editable PPTX, and a JPEG contact sheet you read to SEE the deck. Use when asked to make slides, a deck, a talk, or a presentation, or to edit / render / import a .slaide, .slaide.yaml, or .pptx file.
+paths:
+  - "**/*.slaide"
+  - "**/*.slaide.yaml"
+  - "**/*.slaidec"
+allowed-tools: Bash(slaide *), Bash(npx @aivorynet/slaide *), Bash(npm run slaide *)
+---
+
+# slaide
+
+One `.slaide` file (Markdown + a small YAML header) → web deck + PDF + PPTX. You write content; a reusable **master** (`*.slaide.yaml`) carries the design. Reference layouts / colours / fonts / classes **by name** from the master — never hand-style.
+
+Run as `npx @aivorynet/slaide <cmd>` (or `npm run slaide -- <cmd>` where a script exists; at a monorepo root `npm run slaide -w @aivorynet/slaide -- <cmd>`, which shifts cwd to `core/` — pass **absolute** deck paths).
+
+## Workflow
+1. **Read** `reference.md` (language) and `themes.md` (masters/layouts/footguns). `examples/` is a worked deck + theme.
+2. **`slaide slots <deck>`** — prints the master's real layouts, slots, colours, gradients, sizes, transitions. Reference these **by name**. (Run on the deck, not the master.)
+3. **Write** the `.slaide` — and the master, if authoring one.
+4. **`slaide validate <deck> --strict`** — a **gate**: must be clean. Every `unknown-*` / `low-contrast` / `non-embeddable-font` means something renders wrong even when it "looks valid".
+5. **See it.** You can't open a browser, so: **`slaide shoot <deck> --montage out/sheet.jpg`** tiles every slide into one JPEG — **Read that image.** It's the only way to catch the common defects: overlapping / clipped text, hollow cards, weak contrast, overflow. Iterate until it looks genuinely professional — not just until validate passes.
+
+## Format in 30 seconds
+```
+---
+master: ./theme.slaide.yaml      # omit → bundled "aurora"
+title: My Talk
+~transition: slide-left          # `~` cascades to later slides
+---
+layout: cover
+---
+:: title ::
+My Talk
+:: subtitle ::
+written in slaide
+---
+layout: title-content
+---
+## Why it's nice
+- Plain text in   >>>            # `>>>` = reveal step
+- Beautiful out   >>>
+??? Speaker note (audience never sees this).
+```
+- `---` separates slides; the first config block is deck headmatter; a `key:`-only block after `---` is a slide's frontmatter.
+- `:: name ::` routes Markdown into a layout slot. `[text]{.class}` = styled span (colour `.accent`, gradient `.grad`, size `.lg`). `>>>` = build. `??? text` = note. Inside ``` fences these sigils are literal.
+- Charts: ` ```echart ` (data viz, ECharts option as JSON) and ` ```mermaid ` (diagrams) → theme-coloured SVG. Put a chart in a slot with height (a `1fr` row).
+
+## Authoring a master → themes.md
+Define fonts, a type scale, two-tier colour (palette + roles), gradients, backgrounds, grid layouts, chrome — all data. Reference **roles, not hex**, so a reskin is a palette swap. Past "tidy", give the deck **one signature** (a faint logo-derived motif or a recurring accent panel) and vary composition slide to slide. The load-bearing footguns — dark-on-dark text, hollow `box:` cards, chrome-corner collisions — are flagged in `themes.md`; heed them. A deck about slaide itself: use the shipped brand in the sibling `slaide-hugo` repo, don't invent one.
+
+## Commands (prefix `npx @aivorynet/slaide`)
+| Command | Does |
+|---|---|
+| `slots <deck>` | List the master's vocabulary (source of truth) |
+| `validate <deck> [--strict]` | Line-numbered diagnostics; `--strict` fails on warnings |
+| `shoot <deck> --montage out/sheet.jpg` | All slides → one JPEG contact sheet — the see-it loop (Playwright) |
+| `shoot <deck> --out shots --jpeg` | One image per slide |
+| `build <deck> --out out` | Self-contained HTML; charts baked to SVG |
+| `export <deck> --pdf` · `--pptx` | PDF · editable PowerPoint (Playwright) |
+| `import <file.pptx\|.key>` | PowerPoint/Keynote → slaide |
+| `new <file>` · `themes` · `pack`/`unpack` | scaffold · list themes · bundle `.slaidec` |
+
+If Playwright is missing: `npx playwright install chromium` once.

package/skills/slaide/agents/openai.yaml

@@ -0,0 +1,12 @@
+# Codex-specific skill metadata (Agent Skills open standard).
+# Install this skill folder under .agents/skills/slaide for OpenAI Codex.
+display_name: slaide
+description: Author and render slaide presentations (markdown + YAML → web deck + PDF).
+icon: "🎞️"
+brand_color: "#6C8Cff"
+policy:
+  allow_implicit_invocation: true
+dependencies:
+  tools:
+    # Optional: if the slaide MCP server is registered, Codex can use its tools.
+    - slaide