rune-slides

Generate Marp-compatible slide decks from structured JSON schemas.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/dangvu008/VietTruyen --skill rune-slides-dangvu008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rune-slides
Source: https://github.com/dangvu008/VietTruyen/tree/main/.agents/skills/rune-slides
Command: npx skills add https://github.com/dangvu008/VietTruyen --skill rune-slides-dangvu008

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Creating presentation decks manually is slow and error-prone, especially when an AI agent needs to produce consistently formatted slides. This Skill converts structured JSON slide schemas into Marp-compatible markdown, standardizing output for tech talks, sprint demos, and tutorials. ## Core Features & Use Cases - JSON-to-Marp Conversion: Define slides as a typed JSON schema (title, content, code, diagram, image, quote, section) and build a complete deck with one script call. - Multiple Presentation Templates: Supports demo walkthroughs, sprint reviews, tech talks, tutorials, and pitch formats with typical slide structures. - Speaker Notes & Diagrams: Embeds speaker notes as HTML comments and renders Mermaid diagrams and syntax-highlighted code blocks. - Use Case: After a sprint, ask the agent to create a sprint review deck — it generates the JSON schema, runs build-deck.js, and outputs a deck.md you can preview or export to PDF with Marp CLI. ## Quick Start Ask the agent to create a sprint review slide deck covering goals, completed work, metrics, and next steps, then preview the generated deck.md with Marp CLI.

Frequently Asked Questions about rune-slides

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

FAQPage Schema
How do I create a Marp slide deck from JSON?

Define your slides in a JSON file with a title and a slides array using types like title, content, code, diagram, quote, or section. Then run node build-deck.js --input slides.json --output deck.md to generate Marp-compatible markdown.

What slide types does the JSON schema support?

The schema supports seven slide types: title, content, code, diagram, image, quote, and section. Code slides accept a language and source, while diagram slides render Mermaid syntax blocks.

Does this require Marp to be installed?

No, Marp installation is not required to generate the deck. The script outputs standard markdown that Marp can consume; you install @marp-team/marp-cli separately only when you want to preview or export to PDF.

What happens if build-deck.js is not available?

The agent falls back to generating the Marp markdown directly without the script. The build script is an optimization for consistent formatting, not a hard dependency.

How many slides should a generated deck contain?

Keep decks to 5-15 slides for demos and 10-25 for talks. Decks exceeding 30 slides should be split into multiple decks or summarized to stay manageable.