Skip to content
Skills Library
Documents & office · Building & coding

slidesage

/slidesage

Generate beautiful, static .pptx presentations whose structure is driven by storytelling and instructional design — no animation, but a deliberate narrative sequence with section "transition" beats. Use when the user wants a slide deck, presentation, PowerPoint, .pptx, pitch, keynote, business review, report-out, lecture, course, or workshop. Defaults to a persuasive BUSINESS narrative; switch to EDUCATION mode for Bloom's-aligned, learning-science decks. Produces a storyboard, then renders a designed deck in one of six visual styles. Works with any LLM agent that supports the open Skill forma

Repository
slidesage ↗
Licence
MIT
Last repository change
04.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 04.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Generate beautiful, static .pptx presentations whose structure is driven by storytelling and instructional design — no animation, but a deliberate narrative sequence with section "transition" beats. Use when the user wants a slide deck, presentation, PowerPoint, .pptx, pitch, keynote, business review, report-out, lecture, course, or workshop. Defaults to a persuasive BUSINESS narrative; switch to EDUCATION mode for Bloom's-aligned, learning-science decks. Produces a storyboard, then renders a designed deck in one of six visual styles. Works with any LLM agent that supports the open Skill forma

Triggers from the description

transition
Original author description

Generate beautiful, static .pptx presentations whose structure is driven by storytelling and instructional design — no animation, but a deliberate narrative sequence with section "transition" beats. Use when the user wants a slide deck, presentation, PowerPoint, .pptx, pitch, keynote, business review, report-out, lecture, course, or workshop. Defaults to a persuasive BUSINESS narrative; switch to EDUCATION mode for Bloom's-aligned, learning-science decks. Produces a storyboard, then renders a designed deck in one of six visual styles. Works with any LLM agent that supports the open Skill forma

How it works

  1. When to use this skill
  2. Operating principles (read before generating)
  3. Workflow
  4. The storyboard contract
  5. Requirements
  6. Provider portability
  7. Reference index (load on demand)
Original SKILL.md headings · 128 lines, 893 words
SKILL.md preview
---
name: slidesage
description: >-
  Generate beautiful, static .pptx presentations whose structure is driven by
  storytelling and instructional design — no animation, but a deliberate
  narrative sequence with section "transition" beats. Use when the user wants a
  slide deck, presentation, PowerPoint, .pptx, pitch, keynote, business review,
  report-out, lecture, course, or workshop. Defaults to a persuasive BUSINESS
  narrative; switch to EDUCATION mode for Bloom's-aligned, learning-science
  decks. Produces a storyboard, then renders a designed deck in one of six
  visual styles. Works with any LLM agent that supports the open Skill format.
license: MIT
---

# SlideSage

Turn a topic into a **static but stunning `.pptx`** whose order and content are driven by a
**storytelling + instructional-design engine**. You (the agent) reason out a *storyboard*; a deterministic
Node renderer turns it into a designed deck. No motion — the **sequence of slides and the section-divider
"transition" beats** carry the narrative.

Two modes:

- **`business`** *(default, priority)* — persuasive, executive-ready decks: pitches, keynotes, QBRs,
  strategy, reports. Narrative arc = Pyramid Principle / Situation→Complication→Resolution.
- **`education`** *(toggle)* — teaching decks with Bloom's-aligned objectives, prerequisite sequencing, and
  learning-science beats (retrieval practice, spacing, worked examples).

## When to use this skill

Trigger when the user asks to create a presentation, slide deck, PowerPoint, `.pptx`, pitch, keynote, business
review, report-out, lecture, course, or workshop. If the user explicitly wants **animated or web/HTML** slides,
this skill is the wrong tool (it is static `.pptx` by design) — say so and stop.

## Operating principles (read before generating)

1. **Understand content before style.** Run the storyboard steps first; apply visual style last.
2. **One message per slide**, written as an **action title** — a full-sentence takeaway, never a topic label.
   Reading the titles top-to-bottom must tell the whole story on its own.
3. **Lead with the answer (business) / lead with the objective (education).** In `business` mode use the
   Pyramid Principle: state the recommendation first, then support it. In `education` mode, objectives drive
   what appears and in what order.
4. **Separation of concerns.** Your job is the *storyboard* (`storyboard.json`); the script does the
   rendering. Never hand-write PPTX XML.

## Workflow

### Step 1 — Brief
Fill `templates/brief.template.md` with the user: topic, audience, the single goal (the decision you want, or
the thing learners can do after), `mode` (`business` default / `education`), time budget, hard constraints, and
a style preference. Ask only what you can't reasonably infer.

### Step 2 — Build the storyboard spine
- **business:** Read `references/narrative-frameworks.md`. Identify the **governing thought** (the one-line
  recommendation), then the supporting pillars (MECE), then evidence. Map to
  Situation→Complication→Question→Resolution→Ask.
- **education:** Additionally read `references/instructional-design.md` and `references/learning-science.md`.
  Write **learning objectives** with Bloom's 2001 verbs, list **concepts + prerequisites**, and place
  pedagogy beats (worked examples, retrieval checks, spaced recaps).

### Step 3 — Storyboard + narrative transitions
Read `references/deck-architecture.md`. Produce `storyboard.json` conforming to
`schemas/storyboard.schema.json`. Insert **section-divider slides** ("where we've been → where we're going")
at each act boundary — these are the narrative transitions. Validate:

```bash
node scripts/validate-storyboard.mjs storyboard.json
node scripts/check-dag.mjs storyboard.json   # education mode: no concept taught before its prerequisite
```

### Step 4 — Pick a visual style
Read `references/style-systems/README.md` and choose ONE of:
`futuristic-tech` (dark) · `corporate-bright` (light) · `japanese-editorial` · `soft-clay-3d` ·
`minimalist-luxury` · `modern-illustration` · `hand-drawn-editorial`. Tokens live in
`assets/style-tokens/<style>.json`.

### Step 5 — Render
```bash
npm install            # first run only
node scripts/generate.mjs --in storyboard.json --style corporate-bright --out deck.pptx
```
Add a brand logo pinned to the top-right of every slide with `--logo path/to/logo.png` (or set `meta.logo`
in the storyboard). Titles automatically reserve space so they never run under the logo. If the logo has a
white/light wordmark, recolor it for light backgrounds first.

### Step 6 — (Optional) motion — OFF by default
Only if the user asks for motion. Two independent, stackable injectors:

**Slide transitions** (between slides). Pass the storyboard so section dividers turn like a chapter (push) and
the rest fade:
```bash
node scripts/inject-transitions.mjs --in deck.pptx --storyboard storyboard.json
```

**Click builds** (within a slide): the title appears on the first click, then each body topic appears one-by-one
on subsequent clicks. Run this AFTER transitions:
```bash
node scripts/inject-builds.mjs --in deck.pptx
```
Builds target the shapes the renderer tags `sage-title` / `sage-body`, so they apply automatically to content,
data, summary, two-column, comparison, and call-to-action slides. These are intricate OOXML animations —
confirm playback in PowerPoint before presenting.

### Step 7 — QA gate (always)
```bash
node scripts/qa-report.mjs --storyboard storyboard.json --deck deck.pptx
```
Fix every FAIL before delivering. Checklist source: `references/qa-checklist.md` (one message/slide, action
titles, contrast, MECE pillars, DAG order satisfied in education mode, citations present where claims are made).

## The storyboard contract

The single artifact you author. See `schemas/storyboard.schema.json` and `templates/storyboard.example.json`.
Each slide carries an `archetype`, an `actionTitle`, what it `covers`/`teaches`, a `visual` spec, a
`narrativeRole`, and speaker `notes`. Keep it declarative — describe intent, not PPTX primitives.

## Requirements

- **Node.js ≥ 18** and `npm install` in the skill root (PptxGenJS + a zip lib for the optional fade).
- No network needed at render time; fonts are embedded or substituted per style token.

## Provider portability

This skill is plain text + Node scripts following the open Skill convention. Any LLM agent that can read
`SKILL.md`, write a JSON file, and run a shell command can use it. The storytelling/pedagogy reasoning is
model-agnostic; only the renderer is fixed, so output is consistent across providers.

## Reference index (load on demand)

| File | Use it for |
|---|---|
| `references/narrative-frameworks.md` | Pyramid Principle, S-C-R, action titles, transition beats |
| `references/deck-architecture.md` | slide archetypes + deck skeletons (business & education) |
| `references/instructional-design.md` | Bloom's, backward design, objectives *(education)* |
| `references/learning-science.md` | retrieval, spacing, interleaving, cognitive load *(education)* |
| `references/concept-sequencing.md` | building/validating the prerequisite graph *(education)* |
| `references/slide-patterns.md` | per-archetype layout recipes |
| `references/chart-design.md` | data-visualisation styling |
| `references/style-systems/*` | the six visual systems + how to choose |
| `references/qa-checklist.md` | the pre-delivery gate |
Files in this package (7)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • PLAN.md 11 KB
  • README.md 6 KB
  • SKILL.md 7 KB
  • package-lock.json 7 KB
  • package.json 1 KB

Versions

The database has no other skills named slidesage.

Database snapshot: 13.11.2026 · package version b16e270e2606 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90Presentations
    Read, create or edit PowerPoint or Google Slides decks. Use for presentation, slide deck, PowerPoint, PPT, PPTX, or Google Slides requests.
  • 100pitch-deck-builder
    Build investor-ready pitch decks and sales presentations — 10-11 slide structure, persona-customized per role, storytelling frameworks, speaker notes, and visual direction. Use when creating pitch decks, sales decks, investor decks, board presentations, or any slide-based…
  • 100powerpoint
    Create designed, editable PowerPoint .pptx presentations with PptxGenJS. Use when the user asks to create, generate, update, or inspect a deck, slide deck, presentation, or .pptx file.
  • 100kinsy
    Create a finished, editable PowerPoint (.pptx) deck from a brief, notes or documents with the Kinsy CLI. Use when the user asks for slides, a deck, a presentation, a pitch, a lecture or a board update; it returns a .pptx that opens in PowerPoint as designed, plus a web link to…
  • 100pptx-official
    Generating PowerPoint presentations with pptxgenjs in Node.js. Use when creating automated presentations, slide decks, pitch decks, or reports in .pptx format from data.
  • 100deck-pptx
    Build an editable PowerPoint (.pptx) presentation from a topic or an outline. Use it when the user asks for a deck, slides or a presentation and wants a .pptx file they can open and edit.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.