Agent skill

Marp Slides

by Mathews-Tom in Mathews-Tom/armory

Author MARP markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli.

MITAuto-check passedDocuments & Office

Install Marp Slides

skills CLI
$ npx skills add Mathews-Tom/armory --skill marp-slides -a claude-code

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

GitHub CLI
$ gh skill install Mathews-Tom/armory marp-slides --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/Mathews-Tom/armory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/marp-slides .claude/skills/marp-slides && 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-slides
GitHub stars
329
Token cost
~1.4k tokens
SKILL.md length
678 words
Files
9 (incl. references)
Skills in repo
80
Repo updated
First seen
Licence
MIT

At a glance

Author MARP markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli.

  • Works in 5 steps: Gather Requirements → Load References On-Demand → Compose the Deck → …
  • Markdown slides
  • SKILL.md covers When This Skill Triggers, When NOT to Use This Skill, Step 0: Gather Requirements and Step 1: Load References…, plus 4 more sections
  • Calls npx

What it does

Marp Slides is an agent skill from Mathews-Tom/armory. Author MARP markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli. Covers Marpit directives, custom CSS themes, SVG chart recipes, and dashboard components. Triggers on: "marp", "marp deck", "markdown slides", "slides from markdown", "marp-cli", "pdf from markdown", "pptx from markdown".

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `evals/cases.yaml`, `references/COMPONENTS.md` and `references/DIRECTIVES.md`).

It sits in Documents & Office, covering Slides and decks. It works with Microsoft PowerPoint. The repository describes itself as: Curated, production-grade skills for AI coding agents. Battle-tested workflows for developers who use AI seriously. The licence is MIT.

When your agent uses it

  • Markdown slides
  • Slides from markdown
  • Pdf from markdown
  • Pptx from markdown

Example prompts

  • “marp deck”
  • “markdown slides”
  • “slides from markdown”
  • “/marp-slides”

Requirements

  • Node.js

Workflow steps

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

  1. Gather Requirements
  2. Load References On-Demand
  3. Compose the Deck
  4. Verify Before Handoff
  5. Export

What it can do on your machine

Read from SKILL.md and the folder at commit 4594fb7. 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 Slides loads about 1.4k tokens when it runs, and up to ~15k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 678 words of instructions outside code blocks.

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

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

The full file from Mathews-Tom/armory at commit 4594fb7, republished under its MIT licence (© Mathews-Tom). 678 words, ~1,418 tokens.

Download SKILL.mdSave it as .claude/skills/marp-slides/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
marp-slides
description
Author MARP markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli. Covers Marpit directives, custom CSS themes, SVG chart recipes, and dashboard components. Triggers on: "marp", "marp deck", "markdown slides", "slides from markdown", "marp-cli", "pdf from markdown", "pptx from markdown".
metadata.version
1.0.0
metadata.category
visualization
metadata.tags
slides, presentation, marp, markdown, pdf, pptx
metadata.difficulty
intermediate

MARP Slides Skill

Author slide decks as plain Markdown using the MARP ecosystem (Marpit + Marp Core + marp-cli) and export to PDF, PowerPoint, or self-contained HTML. Decks are single .md files, git-friendly, and themable with plain CSS.

When This Skill Triggers

  • User asks for a MARP deck by name
  • User wants "markdown slides" or "slides from markdown"
  • User wants a .md file they can commit to git and regenerate deterministically
  • User mentions marp-cli, Marpit directives, or asks to theme slides with CSS
  • User wants CLI-exportable PDF or PPTX sourced from a text document

When NOT to Use This Skill

User wantsUse instead
Reveal.js / browser-native HTML presentation with scroll navhtml-presentation
Edit a binary .pptx with native PowerPoint features (animations, transitions set in PowerPoint)document-skills:pptx
Static poster or single-page visualconcept-to-image
Animated explainer videoconcept-to-video

Step 0: Gather Requirements

Before generating anything, confirm in a single message. Use defaults silently for anything the user declines to specify — never ask twice.

ParameterOptionsDefault
Export targetpdf, pptx, html, allpdf
Themedark-dashboard, light-editorial, or MARP built-in (default, gaia, uncover)dark-dashboard
Aspect ratio16:9, 4:316:9
Slide countinteger or autoauto
Visual densityminimal (text-first), standard (mixed), dashboard (charts + metric cards)standard
Brandinglogo path, accent color hexnone

Step 1: Load References On-Demand

Do NOT read all reference files up front. Based on user intent, load only what is needed. This keeps the skill within armory's token-efficiency budget.

User intentLoad
Any deck (always required)references/DIRECTIVES.md — Marpit directives, frontmatter schema, image syntax
Custom theme or CSS stylingreferences/THEMES.md — dark-dashboard and light-editorial starter CSS
Charts, dashboards, metric cards, SVG visualsreferences/COMPONENTS.md — SVG chart recipes, cards, status tags, icons
Export to PDF/PPTX/HTML or imagereferences/EXPORT.md — marp-cli flags, Chrome dependency, --html flag
User wants a concrete example to matchreferences/examples/ — 3 curated decks: dashboard.md, editorial.md, technical.md

Step 2: Compose the Deck

  1. Start with frontmatter. Every deck begins with a YAML front-matter block setting theme, paginate, header, footer, and optionally global style. See DIRECTIVES.md for the full schema.
  2. Split slides with ---. A horizontal rule on its own line creates a new slide. Frontmatter must come before the first slide break.
  3. First slide = title. Use <!-- _class: lead --> to center the title slide, and <!-- _paginate: skip --> to hide it from the page count.
  4. Middle slides = content. Prefer one idea per slide. If density is dashboard, use metric cards and SVG charts from COMPONENTS.md. If density is minimal, use large headings and whitespace.
  5. Last slide = summary/CTA. Mirror the lead class on the closing slide for visual symmetry.
  6. Background images use extended syntax: ![bg](url), ![bg left:40%](url), ![bg brightness:0.3 blur:2px](url). Multiple ![bg] tags on one slide arrange horizontally; add vertical for a column layout.
Show full SKILL.md (232 more words)Show less

Step 3: Verify Before Handoff

  • Frontmatter block present and valid YAML
  • theme: matches a known name (built-in or custom in the file's global style: block)
  • Every slide break is --- on its own line with blank lines around it
  • Relative image paths only (MARP's --allow-local-files requires this for PDF export)
  • If using raw HTML (SVG, custom divs), confirm the export command uses --html
  • Run the export command once locally to confirm no directive warnings

Step 4: Export

See references/EXPORT.md for the full command reference. Minimal invocation:

bash
npx @marp-team/marp-cli@latest slides.md --pdf --allow-local-files --html

This skill wraps the MIT-licensed MARP ecosystem. See root ATTRIBUTIONS.md for upstream credits.

Design Rules

  1. One idea per slide. MARP clips overflow silently — there is no warning for content that runs off the bottom.
  2. Paginate: skip on title and divider slides. paginate: hold on appendix slides.
  3. Relative paths only for images. Absolute paths break in VS Code preview and PDF export.
  4. --html is required for any SVG, <div>, <details>, or inline styling. Without it, MARP escapes HTML tags to text.
  5. Cap lists at 6 rows on content slides. Use details collapsibles or a second slide for more.
  6. Headings carry meaning: h1 for slide title, h2 for subtitle, h3 for uppercase section labels. Consistent hierarchy = consistent visual rhythm.
  7. Never hardcode theme CSS into every slide. Define it once in the global <!-- style: | --> directive or a separate .css file loaded via theme:.

© Mathews-Tom, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in skills/marp-slides of Mathews-Tom/armory.

  • SKILL.md
  • evals/cases.yaml
  • references/COMPONENTS.md
  • references/DIRECTIVES.md
  • references/EXPORT.md
  • references/THEMES.md
  • references/examples/dashboard.md
  • references/examples/editorial.md
  • references/examples/technical.md

Open the folder on GitHubat commit 4594fb7

Compare with similar skills

Marp Slides 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 Slides compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marp Slides this skillMathews-Tom/armory329—~1.4kAutomated safety check: PassMIT
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
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0
Paper Deckzsyggg/paper-craft-skills1.3k—~1.4kAutomated safety check: PassNone

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
  • 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
  • Paper Deck

    zsyggg/paper-craft-skills

    将论文、技术文章或知识内容制作成高真实感的 AIGC 幻灯片。先做叙事结构和逐页视觉导演,再调用生图模型生成每一页 16:9 slide image,最后合成为 PPTX/PDF。适合论文汇报、组会、公开课、技术分享、商业化研究展示;当用户提到“论文PPT”“AI生成PPT”“不像AI的PPT”“高质感幻灯片”“逐页生图PPT”时使用。

    1.3k GitHub stars~1.4k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • HTML Slide To PPTX

    mucsbr/ppt-agent-workflow-san

    Convert structured single-slide or small deck HTML files into editable PPTX slides with native text boxes, shapes, chips, arrows, and panels.

    645 GitHub stars~1.1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from Mathews-Tom/armory

All 80 skills in this repo
  • Architecture Reviewer

    Mathews-Tom/armory

    Architecture reviews across 7 dimensions (structural, scalability, enterprise readiness, performance, security, ops, data) with scored reports.

    329 GitHub stars~4.6k tokensUpdated 4 days ago
    Auto-check passed
  • Concept To Image

    Mathews-Tom/armory

    Turn concepts into static HTML visuals exported as PNG or SVG files via HTML/CSS/SVG.

    329 GitHub stars~2.6k tokensUpdated 4 days ago
    Auto-check passed
  • Watch

    Mathews-Tom/armory

    A skill your agent uses when analyzing an existing video URL or local recording: "watch this video", "analyze youtube video", "summarize this video", "youtube transcript", "find this moment", "what…

    329 GitHub stars~2.8k tokensUpdated 4 days ago
    Auto-check passed
  • Code Refiner

    Mathews-Tom/armory

    Deep code simplification and refactoring preserving behavior across Python, Go, TypeScript, Rust.

    329 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed
  • Concept To Video

    Mathews-Tom/armory

    Turn concepts into animated explainer videos using Manim (Python) with MP4/GIF output, audio overlay, multi-scene composition.

    329 GitHub stars~4.9k tokensUpdated 4 days ago
    Auto-check passed
  • Decision Map

    Mathews-Tom/armory

    Maps the unresolved architecture, policy, and scope decisions that must be answered before planning can start: one durable decision ticket per question on the issue tracker, typed and blocker-linked…

    329 GitHub stars~2.7k tokensUpdated 4 days ago
    Auto-check passed

Questions about Marp Slides

What does Marp Slides do?

Author MARP markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli. Marp Slides is an agent skill from Mathews-Tom/armory. Author MARP markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli.

When should I use Marp Slides?

Marp Slides fits situations like: markdown slides; slides from markdown; pdf from markdown; pptx from markdown.

How do I install Marp Slides in Claude Code?

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

How do I install Marp Slides in Codex?

Run `npx skills add Mathews-Tom/armory --skill marp-slides -a codex`. Or copy the skill folder (skills/marp-slides in Mathews-Tom/armory) into .agents/skills/marp-slides in your project. Codex loads it when a task matches its description.

Can I use Marp Slides 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 Mathews-Tom/armory --skill marp-slides -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-slides, .gemini/skills/marp-slides, .github/skills/marp-slides and .opencode/skills/marp-slides in your project.

What does Marp Slides need to run?

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

Does Marp Slides 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 Slides 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 Slides use?

Marp Slides is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Marp Slides use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 14k tokens, read only when the agent opens those files.

What are the alternatives to Marp Slides?

Skills that share tags, products or a category with Marp Slides: 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 Gpt Image2 Ppt (JuneYaooo/gpt-image2-ppt-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Marp Slides?

Mathews-Tom (a GitHub user) maintains it in Mathews-Tom/armory, which has 329 GitHub stars. The repository holds 80 skills in this directory. The repository was last updated on October 6, 2026.

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