# Slidev Skill: write Slidev slide decks with your assistant (slidevjs/slidev) — skill card for AI agents

> AgentGid skill card. Checked on 2026-10-30 against commit a42aff2 (version 1.0.0).
> Every fact comes from the pack's own files at that commit. Numbers marked "as reported" are the author's.
> Human page: https://agentgid.com/skills/slidevjs/slidev/

> Note: the pack has changed since this check; re-read its files before relying on details.

## Explain it to a non-programmer
The official Slidev guide for your AI assistant. Slidev turns a Markdown text file into web slides for talks and lessons. With this skill your assistant knows how to write those slides: layouts, code on slides, click-by-click reveals, diagrams, math, speaker notes and export to PDF or PowerPoint.

## Who it is for
- You make talks, workshops or lessons with Slidev, or want to start, and use Claude Code or another assistant that reads skills
- Your slides show code and you want highlighted lines, step-by-step code reveals or code that runs on the slide
- You want diagrams (Mermaid, PlantUML) or math formulas on slides without looking up the syntax
- You need to export a deck to PDF, PowerPoint or images, or put it online
- Not for: You make slides in PowerPoint, Keynote or Google Slides: the skill only covers Slidev's own Markdown format
- Not for: You want a design or look for your slides: it lists Slidev's layouts and themes, it does not design slides for you

## What it is
- Kind: knowledge
- License: MIT
- Repository: https://github.com/slidevjs/slidev

## What it does
- Slide basics: --- between slides, the first block of settings configures the whole deck, comments become speaker notes
- Ten core references: syntax, animations, deck and per-slide settings, commands, built-in components and layouts, export, hosting, navigation
- Code on slides: highlighted lines (also step by step on click), line numbers, tabs, a live editor, code that runs on the slide, animated code changes (magic-move), TypeScript type popups
- Diagrams and math: Mermaid, PlantUML and LaTeX
- Layout and style: canvas size, zoom, two-column slots, scoped styles, draggable elements, icons
- Animation: click reveals, hand-drawn underlines and circles, drawing on slides, transitions
- Presenting: presenter notes, timer, camera and screen recording, remote control over the network
- Export and hosting: PDF, PowerPoint (image or editable), PNG, Markdown, a static website, SEO and preview images
- Slidev's built-in MCP server: tools to read, edit, reorder and jump between slides

## Skills
| Skill | Call | Changes code? | In plain words |
|---|---|---|---|
| slidev | loads by itself when you ask for Slidev slides (not a slash command); or plain language | yes | Writes and edits Slidev slides, and knows how to preview, export and publish them |

### slidev
- Asks for: A topic or outline for a new deck, or an existing slides.md to change
- Asks for: What you need on the slides: code, diagrams, two columns, click reveals
- Asks for: How you will share it: PDF, PowerPoint, images or a website
- Gives: A Slidev Markdown file with deck settings, slides, layouts and speaker notes
- Gives: Code blocks with line highlighting, step reveals or magic-move animations
- Gives: Mermaid, PlantUML or LaTeX blocks
- Gives: The commands to preview, build or export, and the settings for PDF download and SEO tags
- Say: "Create a Slidev presentation about TypeScript generics with code examples"

## Know before installing
- The skill is only reference text. It does not install anything, but it tells your assistant to create projects and add packages with pnpm, and export needs the playwright-chromium package (a headless browser) in your project.
- The references were generated from the Slidev docs at v52.11.3 (January 2026); the repo is at 53.0.0. Some newer features (the MCP server, editable PowerPoint) are already in, but the generation log lists only the first run, so a few details may lag the docs.
- The writable code editor feature saves edits straight into real files in your project; the reference itself warns to back up first.
- Some features it may suggest send data out: remote mode with a tunnel puts your presentation on the internet through Cloudflare, and PlantUML diagrams are rendered by the public plantuml.com server unless you set your own.
- It tells your assistant to prefer Slidev's own MCP tools over plain text edits when adding, removing or moving slides, if that server is connected.

## Install (official commands)
- Any agent (skills tool): `npx skills add slidevjs/slidev` — Official command from the skill README and the Slidev docs page Work with AI (sli.dev). Installs skills/slidev.
- Claude Code (plugin): The repo ships .claude-plugin/marketplace.json (marketplace slidev-plugins, plugin slidev, source the repo root). The repo gives no install command for it.
- Slidev MCP server (optional, separate): `claude mcp add --transport http slidev http://localhost:3030/__mcp` && `slidev mcp slides.md` — Not a skill: connects your assistant to Slidev's built-in MCP server, from a running preview or as a standalone process. Turn it off with mcp: false in the deck settings.

## What runs on the user's machine
- Code on the machine: no
- Network: none
- Install: Markdown only: SKILL.md, a README and 53 reference files. No hooks, no scripts, no install steps.
- Skill at work: Tells your assistant to run Slidev commands in your project: pnpm create slidev, pnpm run dev (a preview at localhost:3030), build, export, and pnpm add -D playwright-chromium. These download packages from npm and write the deck, build output and exported files in your project.
- Rest of the repo: Slidev itself (the command-line tool, the VS Code extension, the docs site) is not part of the skill and is not installed by npx skills add.

## Settings
- `mcp: false`: In the deck settings: turns off Slidev's built-in MCP server
- `download: true`: In the deck settings: builds a PDF next to the website and adds a download button
- `plantUmlServer`: In the deck settings: your own PlantUML server instead of plantuml.com

## Examples (from the pack's own files)
- The basic deck the skill starts from: output format defined in skills/slidev/SKILL.md
- Prompts from the official docs: output format defined in docs/guide/work-with-ai.md

## Mistakes to avoid
- Not: Run the PDF, PowerPoint or PNG export in a fresh Slidev project and stop at the browser error. Instead: Add playwright-chromium as a dev dependency first (ask the person), then export. Why: Export renders the slides in a headless browser that the project does not have by default
- Not: Point images at relative paths like ./pic.png. Instead: Put local images in public/ and reference them with a leading slash (/pic.png). Why: The skill's own reference says relative paths are not the way to load local images
- Not: Promise a fully editable PowerPoint from --format pptx-editable. Instead: Tell the person that diagrams, formulas and some slides stay pictures and fonts must be installed on the viewing machine. Why: Only what can be rebuilt as shapes becomes editable; the rest falls back to images
- Not: Use the MCP server to remove or move the first slide of the deck. Instead: Edit the deck settings in the first slide instead; reorder only the slides after it. Why: The first slide's frontmatter is the settings block for the whole deck
- Not: Use onMounted / onUnmounted in a slide component for per-slide setup. Instead: Use Slidev's slide hooks described in the api-slide-hooks reference. Why: The component stays alive when its slide is not shown

## What leaves the machine
- The text of PlantUML diagrams in the deck, to render them → The public PlantUML server (www.plantuml.com) by default, When a slide has a plantuml code block and the deck is previewed, built or exported. Opt out: Set plantUmlServer in the deck settings to your own server, or use Mermaid instead
- The running presentation, reachable by anyone with the public link → Cloudflare Quick Tunnels, Only when Slidev is started with --remote --tunnel. Opt out: Do not use --tunnel; use --remote on the local network, with a password

## Lines in the pack aimed at agents (ask the person first)
- "**Export prerequisite**: `pnpm add -D playwright-chromium` is required for PDF/PPTX/PNG export. If export fails with a browser error, install this dependency first." (skills/slidev/SKILL.md): Adding playwright-chromium downloads a headless browser into the project; ask the person before installing it.
- "npx playwright install chromium" (skills/slidev/references/core-exporting.md): Unpinned npx command that downloads browser binaries (given for CI); ask the person before running it and pin the Playwright version the project uses.

## May I use it like this?
- commercial-app: yes (MIT: keep the license notice)
- redistribute-files: yes (MIT: keep the copyright and permission notice in copies)
- client-work: yes (MIT allows use in work for others)
- inside-app-bundle: yes (MIT: include the copyright and permission notice)

## Which one to pick
- If You write developer talks as one Markdown file with code highlighting, click animations and PDF/PPTX export through Slidev: skill:slidevjs/slidev
- If You want the agent to build slides as a web page with its own frontend code, without a slide framework: skill:zarazhangrui/frontend-slides
- If You want to preview two slides, approve, then build and export to PowerPoint: skill:arifszn/slide-wright
- If You make academic talks such as conference talks, seminars or thesis defenses as PowerPoint files: skill:Gabberflast/academic-pptx-skill

## Works well with
- tool:slidev-cli: The skill writes decks for Slidev and uses its commands to preview, build and export
- agent:claude-code: The skill README and the plugin manifest are written for Claude Code
- tool:skills: The official install command is npx skills add slidevjs/slidev

## Works in and needs
- Works in Claude Code: skills folder or plugin
- Works in Any agent with a skills folder: skills CLI
- Works in Any MCP-capable agent: MCP server (Slidev's own, separate from the skill)
- Needs Slidev project with pnpm: The skill's commands create, preview, build and export with pnpm
- Needs playwright-chromium: Needed only for PDF, PPTX and PNG export

## How to tell it works
Install it and ask "Set up click animations to reveal bullet points one by one" in a Slidev project. It works if the assistant uses v-click or v-clicks in slides.md instead of hand-written styles or scripts.

## Safety
The skill is plain reference text with no code of its own. What your assistant runs comes from Slidev and npm. Features like remote tunnels, code runners and file-writing editors are opt-in Slidev features; turn them on only when you mean to. Install the skill only from github.com/slidevjs/slidev.
