New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Marp Deck

by autonomous-ai in autonomous-ai/openharness

Write a keynote-grade slide deck in Marp Markdown (deck.md) — the structure of a great talk, the copy rules, the two keynote themes and their slide classes, offline art (wallpapers, charts, device…

MITAuto-check passedDocuments & Office

Install Marp Deck

skills CLI
$ npx skills add autonomous-ai/openharness --skill marp-deck -a claude-code

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

GitHub CLI
$ gh skill install autonomous-ai/openharness marp-deck --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/autonomous-ai/openharness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/store/agents/marp/skills/marp-deck .claude/skills/marp-deck && 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-deck
GitHub stars
1.2k
Token cost
~2.3k tokens
SKILL.md length
1,120 words
Files
1
Skills in repo
99
Repo updated
First seen
Licence
MIT

At a glance

Write a keynote-grade slide deck in Marp Markdown (deck.md) — the structure of a great talk, the copy rules, the two keynote themes and their slide classes, offline art (wallpapers, charts, device…

  • Works in 6 steps: The shape of a keynote → Copy: write like the person on stage → Design: two themes, one accent, nothing… → …
  • Tasks that involve Slides and decks
  • SKILL.md covers 1. The shape of a keynote, 2. Copy: write like the person…, 3. Design: two themes, one… and 4. Art: art.mjs, offline, in…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Marp Deck is an agent skill from autonomous-ai/openharness. Write a keynote-grade slide deck in Marp Markdown (deck.md) — the structure of a great talk, the copy rules, the two keynote themes and their slide classes, offline art (wallpapers, charts, device frames), the check, and the export.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Slides and decks. The repository describes itself as: The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across… The licence is MIT.

When your agent uses it

  • Tasks that involve Slides and decks

Example prompts

  • “/marp-deck”

Workflow steps

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

  1. The shape of a keynote
  2. Copy: write like the person on stage
  3. Design: two themes, one accent, nothing else
  4. Art: art.mjs, offline, in seconds
  5. The check
  6. Export

What it can do on your machine

Read from SKILL.md and the folder at commit 74c2733. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and bash).

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

  • Network

    No URLs in SKILL.md.

    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 Deck loads about 2.3k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 1,120 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

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 autonomous-ai/openharness at commit 74c2733, republished under its MIT licence (© autonomous-ai). 1,120 words, ~2,259 tokens.

Download SKILL.mdSave it as .claude/skills/marp-deck/SKILL.md (or your agent's skills folder).
name
marp-deck
description
Write a keynote-grade slide deck in Marp Markdown (deck.md) — the structure of a great talk, the copy rules, the two keynote themes and their slide classes, offline art (wallpapers, charts, device frames), the check, and the export.

marp-deck

A deck here is a keynote: black or white, one idea per slide, type you can read from the back of the room, and a picture whenever a picture says it better. This skill is the whole craft. Read it once, then write.

1. The shape of a keynote

Every talk, whatever the subject, follows this arc. Use it as the outline; drop what the talk does not need, never reorder what it keeps.

#SlideClassWhat it does
1OpeningheroThe promise, in a sentence the audience will repeat. A wallpaper behind it.
2The world todaystatementThe problem, felt from the audience's seat. No product yet.
3So we askedstatementThe question that led to the idea. Tension, not answer.
4The ideasectionThe answer, named. A wallpaper. This is the reveal.
5Three pillarspillarsWhat makes it work. Three names, three lines. Never four.
6See itimageThe product, the prototype, the screen — full bleed or in a device frame.
7The numbernumberOne figure, made human. "1,000 songs in your pocket", not "5 GB".
8Proofchart or quoteA chart from real numbers, or one voice who tried it.
9AvailableclosingWhen, where, how much. Plain.
10One more thingomtOptional. Only if there is really one more thing.
11CloseheroThe promise again, shorter. The wallpaper from slide 1.

Ten slides for a ten-minute talk. A longer talk repeats 2–8 per act. A shorter one keeps 1, 4, 5, 7, 11. Section openers (section) mark each act.

2. Copy: write like the person on stage

  • The headline is the sentence you would say out loud. Eight words or fewer. If it needs a comma, it is two slides.
  • Say what it does for someone, not what it is. Benefit, then feature — if the feature is needed at all.
  • One idea per slide. The check warns above 40 words; a keynote slide usually has fewer than
    1. Everything else goes in the speaker notes.
  • Numbers made human. Convert to something a person can feel: time saved a day, songs in a pocket, cups of coffee. Round it. One number per slide.
  • Threes. Three pillars, three reasons, three words. Not two, not five.
  • Verbs, plain words, no jargon. No "leverage", "seamless", "robust", "solution". No adjectives that do not earn their place. No exclamation marks.
  • Tension, then release. Problem, question, answer. The reveal slide is short; the audience finishes the sentence.
  • Speaker notes carry the argument (<!-- notes --> under a slide). The slides carry the punch. Write the notes as spoken sentences, two to five per slide, so the presenter can read them cold — the pane's Presenter view shows them large beside the next slide, and that is where the user rehearses.
  • Never a bulleted paragraph on a slide. If a list is unavoidable, it is three lines of three to five words each. The themes render lists as a clean stack with hairlines, no bullets.

3. Design: two themes, one accent, nothing else

Front matter — pick one theme for the whole deck:

markdown
---
marp: true
theme: keynote-dark      # or keynote-light. Never both in one deck.
paginate: true
---
  • keynote-dark — black, white type. The keynote. Use it unless the talk is about paper, light, health, or the user asks for white.
  • keynote-light — white, near-black type. Airy, daytime.

Rules the themes assume:

  • Huge type, generous space. Headlines up to 132px. Do not shrink text to fit; cut words.
  • One image per slide at most. Full bleed (![bg](…)) or centred (![w:1000](…)). No image next to a paragraph.
  • Art is generated, not found. No clip art, no stock photos, no emoji, no icons. Wallpapers for hero/section/closing, charts for numbers, device frames for screens (section 4). A photo the user supplies goes full bleed or in a frame.
  • One accent colour per deck, #2997ff by default (links, chart bars). Change it only with a reason, then keep it.
  • Consistency is the design. Same overline style, same positions, same wallpaper palette through the deck. Pick a palette on slide 1 and stay with it.
Show full SKILL.md (458 more words)Show less
The slide classes

Set one per slide with a scoped directive on the slide's first line, then the content:

markdown
<!-- _class: hero -->
![bg](assets/hero.svg)
# The best way to give a talk.
Now on every Mac.
ClassContentNotes
hero![bg](…) + # headline + one lineCentred, 132px, no page number. Slides 1 and 11.
statement# one sentence (+ one quiet line)Left, 92px, wraps at 14 characters wide. Problem, question.
section![bg](…) + # nameAn act opener or the reveal.
pillars#### overline + ## headline + a 3-column block (below)Three names, three lines.
image![bg](…) + one caption lineFull bleed. Caption bottom-left.
number# 3× + one line300px gradient figure. The line says what it means.
chart## headline + ![](assets/chart.svg)Centred, chart as wide as the slide.
quote> the words + — who60px, curly quotes drawn for you.
closing# headline + linesAvailability: when, where, price.
omt# One more thing.Then the next slide is the thing.
(none)#### overline + ## headline + text or a listThe plain slide. Use rarely.

Pillars block:

markdown
<!-- _class: pillars -->
#### What makes it work
## Three things.

<div class="columns">
<div>

### Fast
Opens before you sit down.

</div>
<div>

### Quiet
No fans. No noise. Ever.

</div>
<div>

### Yours
Every setting, on every device.

</div>
</div>

Blank lines inside the <div>s matter: they let Markdown render inside HTML. Keep them.

Other directives you may use: <!-- _paginate: false --> on a slide, ![bg right:40%](…) for a half-image slide, ![w:800](…)/![h:400](…) for a sized inline image, <!-- _color: … --> only on an image slide whose picture is light. Nothing else; no inline styles, no other HTML.

4. Art: art.mjs, offline, in seconds

Every deck gets art. All of it is generated into assets/ from the toolchain, deterministic from a seed, no network, no accounts:

sh
# wallpapers: gradient light on black (or --light). Palettes: aurora sunset ocean graphite spectrum
"$MARP_TOOLCHAIN/art" wallpaper -o assets/hero.svg --palette aurora --seed 7
"$MARP_TOOLCHAIN/art" wallpaper -o assets/reveal.svg --palette aurora --seed 12

# a chart from the talk's real numbers: bar (default) or line, in the accent colour
"$MARP_TOOLCHAIN/art" chart -o assets/growth.svg --data "2023:12,2024:31,2025:64" --label "Teams on it" --type bar

# a screenshot or photo in a device, on a wallpaper: phone (default), laptop, window
"$MARP_TOOLCHAIN/art" frame -o assets/demo.svg --image assets/screen.png --kind laptop --palette ocean
  • Same palette across the deck; vary --seed so slides differ. Seeds 1–99 all look good.
  • Charts only from numbers in the talk; never decorate. Four to six points, label the axis in words (--label). Add --light for keynote-light.
  • Frames want a real image in assets/ (PNG, JPG, WebP, SVG). Ask the user for the screenshot if the talk shows a product and none is there; use a wallpaper image slide until it arrives.
  • Never reference an image that is not in the workspace. The check fails the deck.

5. The check

sh
"$MARP_TOOLCHAIN/check"            # deck.md
"$MARP_TOOLCHAIN/check" other.md   # another file

Writes .harness/verdict.json (what the pane header shows) and prints every finding. Errors: the deck does not render, a slide is empty, an image is missing. Warnings: over 40 words on a slide, no image anywhere in the deck, no heading on the first slide, fewer than three slides, no marp: true. Ready = no errors and at least three slides. Polish = no warnings either. The viewer runs the same check on every save; run it yourself to read the list.

6. Export

sh
"$MARP_TOOLCHAIN/marp" deck.md --theme-set "$MARP_THEMES" --allow-local-files --no-stdin -o dist/deck.pdf
"$MARP_TOOLCHAIN/marp" deck.md --theme-set "$MARP_THEMES" --allow-local-files --no-stdin -o dist/deck.pptx
"$MARP_TOOLCHAIN/marp" deck.md --theme-set "$MARP_THEMES" --allow-local-files --no-stdin -o dist/deck.html

--theme-set is what makes the keynote themes real outside the viewer; without it the export falls back to the default theme. PDF and PPTX render through a Chromium-family browser — the machine's, or the headless one setup fetched when it had none; toolchain/doctor.sh says which. HTML needs nothing. --no-stdin matters in a tool shell. Keynote (the app) opens the PPTX.

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

Files

Just SKILL.md in store/agents/marp/skills/marp-deck of autonomous-ai/openharness.

Open the folder on GitHubat commit 74c2733

Compare with similar skills

Marp Deck 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 Deck compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marp Deck this skillautonomous-ai/openharness1.2k—~2.3kAutomated safety check: PassMIT
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.8k—~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.8k GitHub stars~4.3k tokensUpdated 23 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.

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

More from autonomous-ai/openharness

All 99 skills in this repo

  • G-code Slicer Tool

    autonomous-ai/openharness

    Slices 3D mesh files into printer-profiled plain G-code through real slicer CLIs, with backend discovery, input inspection, dry runs and static validation.

    1.2k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Home Assistant Automation Builder

    autonomous-ai/openharness

    Turns a home-automation request into standard, testable automations.yaml, run against Home Assistant Core's real triggers and verified with its own trace tool.

    1.2k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Score Music Composer

    autonomous-ai/openharness

    Turns a musical brief into LilyPond concert-pitch music, checked parts for each instrument and a playable practice pack.

    1.2k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • OrcaSlicer 3MF and G-code Workflow

    autonomous-ai/openharness

    Turns an STL and explicit printer and material requirements into compared OrcaSlicer plans, an editable 3MF project, checked G-code and a portable handoff.

    1.2k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Sheets and Docs Report Builder

    autonomous-ai/openharness

    Builds an editable DOCX report, a formula-driven XLSX workbook and a fresh LibreOffice PDF preview from one structured source file, then checks them together.

    1.2k GitHub stars~708 tokensUpdated today
    Auto-check passed

  • Bambu Labs

    autonomous-ai/openharness

    Dry-run, upload, and cautiously initiate local Bambu Lab print jobs from validated plain .gcode, using Bambu LAN FTPS/MQTT handoffs.

    1.2k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check: warnings

Categories

Questions about Marp Deck

What does Marp Deck do?

Write a keynote-grade slide deck in Marp Markdown (deck.md) — the structure of a great talk, the copy rules, the two keynote themes and their slide classes, offline art (wallpapers, charts, device…. Marp Deck is an agent skill from autonomous-ai/openharness.md) — the structure of a great talk, the copy rules, the two keynote themes and their slide classes, offline art (wallpapers, charts, device frames), the check, and the export.

When should I use Marp Deck?

Marp Deck fits situations like: tasks that involve Slides and decks.

How do I install Marp Deck in Claude Code?

Run `npx skills add autonomous-ai/openharness --skill marp-deck -a claude-code`. Or copy the skill folder (store/agents/marp/skills/marp-deck in autonomous-ai/openharness) into .claude/skills/marp-deck in your project. Claude Code loads it when a task matches its description.

How do I install Marp Deck in Codex?

Run `npx skills add autonomous-ai/openharness --skill marp-deck -a codex`. Or copy the skill folder (store/agents/marp/skills/marp-deck in autonomous-ai/openharness) into .agents/skills/marp-deck in your project. Codex loads it when a task matches its description.

Can I use Marp Deck 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 autonomous-ai/openharness --skill marp-deck -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-deck, .gemini/skills/marp-deck, .github/skills/marp-deck and .opencode/skills/marp-deck in your project.

What does Marp Deck need to run?

SKILL.md names no scripts, command-line tools or credentials: Marp Deck is instructions for the agent only.

Does Marp Deck access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Marp Deck 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 Deck use?

Marp Deck 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 Deck use?

About 2.3k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Marp Deck?

Skills that share tags, products or a category with Marp Deck: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.8k 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 Deck?

autonomous-ai (a GitHub organization) maintains it in autonomous-ai/openharness, which has 1,194 GitHub stars. The repository holds 99 skills in this directory. The repository was last updated on October 9, 2026.

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