convez.ai
SkillEscrita & ConteúdoIntermediário
vedraut

SlideSage

vedraut/slidesage

Gera decks .pptx com estrutura narrativa e design instrucional

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill open-source que transforma um tópico em apresentações .pptx belamente estruturadas, guiadas por design instrucional e narrativa. Funciona com qualquer agente LLM (Claude, OpenAI, etc.) separando o raciocínio da apresentação em dois passos: geração de storyboard JSON e renderização determinística com seis sistemas visuais pré-definidos.

Instalação

$npx convez-ai vedraut/slidesage

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
11
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar pitches de negócios e keynotes com narrativa estruturada
  • Desenvolver material educacional com sequenciamento por objetivos e pré-requisitos
  • Gerar relatórios executivos (QBRs, strategy) com pirâmide de informações

Veredito

Skill sólido que resolve um problema real: gerar apresentações bem estruturadas, não apenas bonitas. Separa raciocínio de renderização de forma elegante, com suporte a dois modos (negócios e educação) e validação de qualidade integrada. Recomendado para times que precisam automatizar decks com coerência narrativa.

README

A tradução para o português deste README ainda está na fila.

SlideSage

An open-source, agent-agnostic skill that turns a topic into a beautiful, static .pptx — with the structure driven by storytelling and instructional design.

No animation. Instead, SlideSage makes decks that flow: a deliberate narrative sequence, action titles that tell the whole story on their own, and section-divider "transition" beats that carry the audience from one idea to the next — exactly how a great keynote or lecture moves. It works with any LLM agent that can read a SKILL.md, write a JSON file, and run a shell command (Claude, OpenAI Codex, and compatible tools).

npm install
node scripts/generate.mjs --in examples/business-pitch/storyboard.json --style futuristic-tech --out deck.pptx

Why it's different

Most AI slide tools either template the look (pretty, empty) or dump text (a wall of bullets). SlideSage separates thinking from rendering:

  1. The LLM reasons out a storyboard — a declarative JSON contract (schemas/storyboard.schema.json) describing objectives, a concept-dependency graph, a narrative arc, and one message per slide.
  2. A deterministic Node/PptxGenJS renderer turns that storyboard into a designed deck in one of six visual systems.

Because the reasoning is model-agnostic and only the renderer is fixed, output is consistent across providers.

Two modes

ModeForEngine
business (default)pitches, keynotes, QBRs, strategy, reportsPyramid Principle + Situation→Complication→Resolution, MECE pillars, hero stats
education (toggle)lectures, courses, workshopsBloom's-aligned objectives, prerequisite (DAG) sequencing, retrieval practice, worked examples, spacing

How it works (the pipeline)

brief → storyboard (story arc + objectives + concept DAG) → validate → pick a style → render .pptx → QA gate
  1. Brief — templates/brief.template.md
  2. Storyboard — author storyboard.json; validate with scripts/validate-storyboard.mjs (and scripts/check-dag.mjs in education mode)
  3. Style — pick one of six systems (references/style-systems/)
  4. Render — scripts/generate.mjs
  5. QA gate — scripts/qa-report.mjs (fails the build on topic-label titles, overloaded slides, uncited charts, uncovered objectives, missing narrative transitions, …)
  6. Optional motion (off by default) — scripts/inject-transitions.mjs adds a subtle section-only fade

See SKILL.md for the full agent-facing workflow and PLAN.md for the architecture.

Visual styles

futuristic-tech · corporate-bright · minimalist-luxury · modern-illustration · soft-clay-3d · japanese-editorial · hand-drawn-editorial. Each is a machine-readable token set in assets/style-tokens/ plus a usage guide in references/style-systems/. Add a brand logo to every slide with --logo path/to/logo.png. Optional, off-by-default motion: fade/push slide transitions (scripts/inject-transitions.mjs) and on-click build animations that reveal the title then each topic one-by-one (scripts/inject-builds.mjs).

Examples

npm run example:business     # examples/business-pitch  → Series A pitch (futuristic-tech)
npm run example:education    # examples/education-lesson → recursion lesson (soft-clay-3d)

Requirements

  • Node.js ≥ 18
  • npm install (PptxGenJS for rendering, JSZip for the optional fade). No network needed at render time.

Using SlideSage as a skill

Drop this repo where your agent looks for skills (e.g. a skills/ directory), or point your agent at SKILL.md. The skill triggers on requests to build a presentation/deck/PowerPoint/pitch/lecture. The agent fills a storyboard and runs the scripts above. Nothing is provider-specific.

Project layout

SKILL.md            agent entry point (triggers + workflow)
schemas/            storyboard + style-token JSON schemas (the contracts)
scripts/            generate, validate, check-dag, qa-report, inject-transitions
references/         storytelling, instructional design, learning science, style systems
assets/             style tokens (+ optional SVG motifs)
templates/          brief + example storyboard
examples/           two end-to-end decks (business + education)

Credits & inspiration

SlideSage stands on the shoulders of excellent open work. Visual design, content discipline, and pedagogy ideas were studied and adapted from:

Gratitude to all these authors. Any errors or opinions in SlideSage are its own.

License

MIT © 2026 Ved Raut. Free for everyone, any LLM, any purpose.

Contributing

Issues and PRs welcome — new style systems (add a token file + guide), more archetypes, or additional language bindings for the renderer. Validate any new style against schemas/style-tokens.schema.json.

Ver o original no GitHub

Bom para

Relacionados