Agent skill

Marp Generator

by dmccreary in dmccreary/ibook-skills

Generates slide decks in the MARP (Markdown Presentation Ecosystem) format and publishes them as live, embeddable presentations on an MkDocs Material site.

CC-BY-NC-4.0Auto-check passedDocuments & Office

Install Marp Generator

skills CLI
$ npx skills add dmccreary/ibook-skills --skill marp-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dmccreary/ibook-skills marp-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dmccreary/ibook-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/archived/marp-generator .claude/skills/marp-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
marp-generator
GitHub stars
105
Token cost
~3.1k tokens
SKILL.md length
1,278 words
Files
4 (incl. references, assets)
Skills in repo
32
Repo updated
First seen
Licence
CC-BY-NC-4.0

At a glance

Generates slide decks in the MARP (Markdown Presentation Ecosystem) format and publishes them as live, embeddable presentations on an MkDocs Material site.

  • Works in 9 steps: Figure out the input and clarify scope → Draft an outline and confirm before… → Write docs/slides//slides.md → …
  • The user wants to turn a topic
  • SKILL.md covers What the user gets, Why HTML export + iframe, not…, High-level workflow and What NOT to do, plus 1 more section
  • Calls npx

What it does

Marp Generator is an agent skill from dmccreary/ibook-skills. Generates slide decks in the MARP (Markdown Presentation Ecosystem) format and publishes them as live, embeddable presentations on an MkDocs Material site. Use this skill whenever the user wants to turn a topic, description, or existing chapter/document into a presentation, slide deck, or set of slides — trigger on phrases like "make a slide deck", "turn this chapter into a presentation", "create slides for X", "I need to present this", "build a deck about Y", or "add a presentation to the site", even if the user…

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files and assets (for example `assets/template.md`, `references/authoring-guide.md` and `references/mkdocs-integration.md`).

It sits in Documents & Office, covering Slides and decks.

When your agent uses it

  • The user wants to turn a topic
  • Existing chapter/document into a presentation
  • Set of slides — trigger on phrases like make a slide deck
  • Turn this chapter into a presentation

Example prompts

  • “make a slide deck”
  • “turn this chapter into a presentation”
  • “create slides for X”
  • “/marp-generator”

Requirements

  • Node.js

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Figure out the input and clarify scope
  2. Draft an outline and confirm before writing full slides
  3. Write docs/slides//slides.md
  4. Export the deck
  5. Write index.md
  6. Write metadata.json
  7. Add the deck to the gallery: docs/slides/index.md
  8. Update mkdocs.yml nav
  9. Report back

What it can do on your machine

Read from SKILL.md and the folder at commit 98a9991. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • marp.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Marp Generator loads about 3.1k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 190 tokens; SKILL.md has 1,278 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~190
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (CC-BY-NC-4.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,278 words (~3,119 tokens).

“This skill turns a topic description or an existing document into a MARP slide deck, exports it to a self-contained HTML file, and wires it into an MkDocs Material site the same way this repo already publishes MicroSims — a…”

— opening of SKILL.md by dmccreary, CC-BY-NC-4.0
name
marp-generator
model
sonnet
license
Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC-SA 4.0)

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references, assets) in skills/archived/marp-generator of dmccreary/ibook-skills.

  • SKILL.md
  • assets/template.md
  • references/authoring-guide.md
  • references/mkdocs-integration.md

Open the folder on GitHubat commit 98a9991

Compare with similar skills

Marp Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Marp Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marp Generator this skilldmccreary/ibook-skills105—~3.1kAutomated safety check: PassCC-BY-NC-4.0
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.9k—~4.3kAutomated safety check: PassMIT
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Ppt Image FirstNyxTides/ppt-image-first1.2k—~1.6kAutomated safety check: PassApache-2.0
Vibe to Agentic Engineering Frameworkshanraisshan/claude-code-best-practice67k—~3.3kAutomated safety check: PassMIT
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0

Similar skills

  • Image To Editable Ppt

    ningzimu/image-to-editable-ppt-skill

    Rebuild slide images, scanned or image-based PPT/PPTX files, and PDF decks into object-level editable PowerPoint (.pptx), preserving speaker notes when supplied.

    2.9k GitHub stars~4.3k tokensUpdated 24 days ago
    Documents & OfficeAuto-check passed
  • Slides

    fcakyon/claude-codex-settings

    Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.

    1.2k GitHub starsUsed in 1 repo~1.1k tokens
    Documents & OfficeAuto-check passed
  • Ppt Image First

    NyxTides/ppt-image-first

    Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

    1.2k GitHub stars~1.6k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Vibe to Agentic Engineering Framework

    shanraisshan/claude-code-best-practice

    Explains the conceptual model behind a presentation on moving from unstructured vibe coding to fully configured agentic engineering, including its 4-level scoring system and slide conventions.

    67k GitHub stars~3.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Gpt Image2 Ppt

    JuneYaooo/gpt-image2-ppt-skills

    Generate visually striking PPT slides via OpenAI's gpt-image-2 -- use any style in styles/<collection/STYLEID.md or mimic a user-supplied .pptx template; outputs high-res slide PNGs and a 16:9 .pptx.

    1.3k GitHub stars~8.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Compiledeck

    scunning1975/MixtapeTools

    Create and compile beautiful Beamer presentations following the Rhetoric of Decks philosophy.

    474 GitHub starsUsed in 2 repos~3.1k tokens
    Documents & OfficeAuto-check passed

More from dmccreary/ibook-skills

All 32 skills in this repo
  • Book Publisher

    dmccreary/ibook-skills

    Publishes and promotes a finished intelligent textbook - GitHub README with badges and site statistics, LinkedIn announcement posts, LinkedIn carousel document posts (PPTX/PDF slideshows), and…

    105 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Linkedin Carousel Generator

    dmccreary/ibook-skills

    Generates a 13-slide LinkedIn carousel (a "document post" — PPTX/PDF) that showcases an intelligent textbook's key features, with real screenshots, mascot art, and metrics pulled from the project.

    105 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Add Xapi Events To Microsim

    dmccreary/ibook-skills

    A skill your agent uses when the user wants an existing MicroSim or chapter quiz to record what students do with it.

    105 GitHub stars~5.6k tokensUpdated today
    Auto-check passed
  • Diagram Reports Generator

    dmccreary/ibook-skills

    Generates a status report of all diagrams and MicroSims across an intelligent textbook's chapters, including difficulty, Bloom's level, and UI complexity.

    105 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • DOCX To Web Publisher

    dmccreary/ibook-skills

    Converts .docx files (papers, briefs, reports) into styled React component pages in a Next.js content-catalog site.

    105 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Book Media Generator

    dmccreary/ibook-skills

    Generates media for intelligent textbooks - slide decks and presentations (MARP web decks in docs/slides/ or PowerPoint .pptx lecture downloads), illustrated stories and graphic novels…

    105 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Marp Generator

What does Marp Generator do?

Generates slide decks in the MARP (Markdown Presentation Ecosystem) format and publishes them as live, embeddable presentations on an MkDocs Material site. Marp Generator is an agent skill from dmccreary/ibook-skills. Generates slide decks in the MARP (Markdown Presentation Ecosystem) format and publishes them as live, embeddable presentations on an MkDocs Material site.

When should I use Marp Generator?

Marp Generator fits situations like: the user wants to turn a topic; existing chapter/document into a presentation; set of slides — trigger on phrases like make a slide deck; turn this chapter into a presentation.

How do I install Marp Generator in Claude Code?

Run `npx skills add dmccreary/ibook-skills --skill marp-generator -a claude-code`. Or copy the skill folder (skills/archived/marp-generator in dmccreary/ibook-skills) into .claude/skills/marp-generator in your project. Claude Code loads it when a task matches its description.

How do I install Marp Generator in Codex?

Run `npx skills add dmccreary/ibook-skills --skill marp-generator -a codex`. Or copy the skill folder (skills/archived/marp-generator in dmccreary/ibook-skills) into .agents/skills/marp-generator in your project. Codex loads it when a task matches its description.

Can I use Marp Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dmccreary/ibook-skills --skill marp-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/marp-generator, .gemini/skills/marp-generator, .github/skills/marp-generator and .opencode/skills/marp-generator in your project.

What does Marp Generator need to run?

Going by SKILL.md and its folder, Marp Generator needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Marp Generator access the network?

SKILL.md names 1 domain. As links in the text: marp.app. This is read from the text; nothing was executed.

Is Marp Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Marp Generator use?

Marp Generator is published under the CC-BY-NC-4.0 licence (declared in SKILL.md).

How many tokens does Marp Generator use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Marp Generator?

Skills that share tags, products or a category with Marp Generator: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.9k stars), Slides (fcakyon/claude-codex-settings, 1.2k stars), Ppt Image First (NyxTides/ppt-image-first, 1.2k stars) and Vibe to Agentic Engineering Framework (shanraisshan/claude-code-best-practice, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Marp Generator?

dmccreary (a GitHub user) maintains it in dmccreary/ibook-skills, which has 105 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 9, 2026.

Source: dmccreary/ibook-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.