ppt-slide-composer

Compose Slidev slides from outline.json and style-plan.md into slides markdown.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/Rory-X/slidev-ppt-agent --skill ppt-slide-composer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ppt-slide-composer
Source: https://github.com/Rory-X/slidev-ppt-agent/tree/main/.agents/skills/ppt-slide-composer
Command: npx skills add https://github.com/Rory-X/slidev-ppt-agent --skill ppt-slide-composer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turning approved outlines and style plans into production-ready Slidev markdown is time-consuming and error-prone when done manually; this Skill automates slide composition while enforcing design tokens, layout rules, and overflow protections so slides are consistent and presentation-ready.

Core Features & Use Cases

  • Automated Slide Composition: Convert outline.json and style-plan.md into a complete slides-<topic>.md using Bento Grid layouts and page templates.
  • Design System Enforcement & Overflow Protection: Apply global CSS tokens, headmatter imports, mermaid scaling, image/table sizing rules, and one-focus-per-page constraints to prevent visual and layout regressions.
  • Presenter Notes & Animation Strategy: Inject structured presenter notes, v-clicks/v-motion rules, and limited reveal animations per slide for live presentation readiness.
  • Use Case: Produce a bilingual technical talk deck from a validated outline, ensuring mermaid diagrams are scaled, tables split when large, and all slides include presenter notes.

Quick Start

Ask the agent to compose final Slidev slides for the approved outline.json and style-plan.md, producing slides-<topic>.md with presenter notes, required design-system CSS, and overflow protections applied.

Frequently Asked Questions about ppt-slide-composer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an approved outline into Slidev markdown automatically?

You can convert an approved outline into Slidev markdown by applying page templates, Bento Grid layouts, and design-system tokens to generate a complete slides document with enforced one-focus-per-page constraints and presenter notes.

How does Bento Grid layout work when composing Slidev slides?

Bento Grid layout in Slidev slides organizes content into structured grid blocks, applying CSS variables and design tokens to ensure consistent visual hierarchy and prevent element overflow across dark and light themes.

Can I scale mermaid diagrams in Slidev to prevent layout overflow?

Yes, mermaid diagrams can be scaled within Slidev slides by applying specific mermaid scaling rules and image overflow protections, ensuring diagrams fit page boundaries without breaking the presentation layout.

What is the best way to add presenter notes and animations to a Slidev deck?

The best way to add presenter notes and animations to a Slidev deck is to inject structured notes alongside limited v-clicks and v-motion reveal animations, ensuring live presentation readiness without overwhelming the audience.

Do I need a separate style plan to generate technical talk slides with Slidev?

Yes, you need a validated style plan and an outline to generate technical talk slides with Slidev, as the composition process applies design-system CSS imports, table splitting rules, and headmatter configurations from these inputs.

Why does my Slidev presentation break when rendering large tables and images?

Slidev presentations break with large tables and images when overflow protections are missing; applying table splitting rules, image sizing constraints, and design-system tokens prevents visual regressions and layout failures.