███████╗██╗ ██╗██████╗ ███████╗██╗ ██╗
██╔════╝██║ ██║██╔══██╗██╔════╝██║ ██║
███████╗██║ ██║██║ ██║█████╗ ██║ ██║
╚════██║██║ ██║██║ ██║██╔══╝ ╚██╗ ██╔╝
███████║███████╗██║██████╔╝███████╗ ╚████╔╝
╚══════╝╚══════╝╚═╝╚═════╝ ╚══════╝ ╚═══╝
A G E N T S K I L L
Give your AI agent the power to create stunning presentations.
Create, edit, theme, build, and export Slidev decks — from any AI agent platform.
AI agents are great at writing code — but when you ask them to make a Slidev presentation, they fumble through CLI docs, forget syntax, and produce broken builds.
This skill fixes that. It gives your agent structured knowledge and battle-tested scripts so it can go from blank file to deployed deck without hand-holding.
| Capability | Script | Formats |
|---|---|---|
| Scaffold a new deck | slidev-init.sh |
— |
| Live-preview edits | slidev-dev.sh |
— |
| Build for production | slidev-build.sh |
Static SPA |
| Export presentations | slidev-export.sh |
PDF, PPTX, PNG, Markdown |
| Eject a theme | slidev-theme-eject.sh |
— |
| Scaffold a custom theme | slidev-theme-scaffold.sh |
— |
All scripts handle edge cases, resolve the Slidev CLI automatically, and work around known CLI bugs — so the agent doesn't have to.
slidev-agent-skill/
│
├── SKILL.md # Orchestration — agent reads this first
│
├── references/
│ ├── index.md # Task-to-reference routing table
│ ├── slidev/ # Official Slidev docs (auto-synced)
│ │ ├── core-syntax.md
│ │ ├── cli.md
│ │ ├── layout.md
│ │ ├── theme-addon.md
│ │ ├── write-theme.md
│ │ ├── directory-structure.md
│ │ ├── exporting.md
│ │ ├── hosting.md
│ │ └── work-with-ai.md
│ └── platforms/ # Platform-specific skill guides
│ ├── claude-skills.md
│ ├── codex-skills.md
│ └── openclaw-skills.md
│
└── scripts/ # Deterministic execution layer
├── _slidev_common.sh # Shared CLI resolution
├── slidev-init.sh
├── slidev-dev.sh
├── slidev-build.sh
├── slidev-export.sh
├── slidev-theme-eject.sh
├── slidev-theme-scaffold.sh
└── sync-references.mjs # Auto-sync docs from sli.dev
The skill follows a strict 4-layer model:
- Orchestration (
SKILL.md) — routing logic and workflow rules - Documentation (
references/) — official docs, loaded on-demand per task - Execution (
scripts/) — deterministic shell scripts wrapping the Slidev CLI - Configuration (
package.json) — minimal, no heavy dependencies
# Clone into your skills directory
git clone https://github.com/6missedcalls/slidev-agent-skill.git \
~/.claude/skills/slidev-agent-skillgit clone https://github.com/6missedcalls/slidev-agent-skill.git \
~/.agents/skills/slidev-agent-skillgit clone https://github.com/6missedcalls/slidev-agent-skill.git \
skills/slidev-agent-skillNo agent-specific packaging required. Works as-is across all platforms.
bashnode>= 18 andnpmplaywright-chromium— required for exports (auto-installable via scripts)
# Create a new deck
./scripts/slidev-init.sh my-talk
cd my-talk
# Start the dev server
../scripts/slidev-dev.sh slides.md --port 3030
# Build for production
../scripts/slidev-build.sh slides.md --out dist
# Export to PDF
../scripts/slidev-export.sh slides.md --format pdf --output my-talk.pdfScaffolds a new Slidev project with slides.md, package.json, and dependencies.
Starts the live-reload dev server for iterative editing.
Builds a deployable static SPA.
slidev-export.sh [entry] [--format pdf|pptx|png|md] [--output file] [--with-clicks] [--range ...] [--dark] [--install-playwright]
Exports the deck. Supports PDF, PowerPoint, PNG, and Markdown formats.
Ejects the active theme into a local directory for full customization.
Scaffolds a brand-new theme package with layouts, styles, and setup files.
All scripts support
--help. Run any script without arguments for usage info.
The agent workflow is intentionally script-first and reference-routed:
1. Agent reads SKILL.md
2. Agent checks references/index.md for task routing
3. Agent loads ONLY the reference files needed
4. Agent executes via scripts/* (not raw CLI)
5. Agent falls back to direct Slidev CLI only when needed
This keeps the agent's context window efficient — it never loads documentation it doesn't need.
| Task | References loaded |
|---|---|
| Create a deck | core-syntax.md, cli.md |
| Edit content and layouts | core-syntax.md, layout.md, directory-structure.md |
| Theme customization | theme-addon.md, write-theme.md, directory-structure.md |
| Build and deploy | hosting.md, cli.md |
| Export | exporting.md, cli.md |
The bundled documentation auto-syncs from the official Slidev docs:
npm run sync:referencesThis fetches the latest content from sli.dev and updates local files with deterministic writes (only changes when content actually differs).
Export fails with Playwright error?
# Auto-install Playwright with the export command
./scripts/slidev-export.sh slides.md --format pdf --install-playwright
# Or install manually
npm i -D playwright-chromiumMarkdown export path issues?
The script automatically handles this — bare filenames are rewritten to out/<name>.md to work around a known Slidev CLI bug.
Theme eject not working?
Theme ejection uses --entry internally for compatibility with current Slidev CLI versions.
# Validate all shell scripts
npm run check:shell
# Refresh references from upstream docs
npm run sync:referencesSee README.quick.md for a contributor cheat sheet.
MIT
Built for agents that present.
Slidev | Claude Code | Codex | OpenClaw