Agent skill

Slidev Migrate

by leochiu-a in leochiu-a/slidev-workspace

Migrate a single Slidev project into a Slidev workspace structure.

Install Slidev Migrate

skills CLI

$ npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a claude-code

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

GitHub CLI

$ gh skill install leochiu-a/slidev-workspace slidev-migrate --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/leochiu-a/slidev-workspace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/slidev-migrate .claude/skills/slidev-migrate && 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/

Paste into Claude Code

Install the "slidev-migrate" agent skill from https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate into .claude/skills/slidev-migrate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "slidev-migrate", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install leochiu-a/slidev-workspace slidev-migrate --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/leochiu-a/slidev-workspace.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/slidev-migrate .agents/skills/slidev-migrate && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "slidev-migrate" agent skill from https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate into .agents/skills/slidev-migrate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "slidev-migrate", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install leochiu-a/slidev-workspace slidev-migrate --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/leochiu-a/slidev-workspace.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/slidev-migrate .cursor/skills/slidev-migrate && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "slidev-migrate" agent skill from https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate into .cursor/skills/slidev-migrate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "slidev-migrate", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/leochiu-a/slidev-workspace.git --path .claude/skills/slidev-migrate

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install leochiu-a/slidev-workspace slidev-migrate --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/leochiu-a/slidev-workspace.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/slidev-migrate .gemini/skills/slidev-migrate && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "slidev-migrate" agent skill from https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate into .gemini/skills/slidev-migrate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "slidev-migrate", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install leochiu-a/slidev-workspace slidev-migrate

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/leochiu-a/slidev-workspace.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/slidev-migrate .github/skills/slidev-migrate && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "slidev-migrate" agent skill from https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate into .github/skills/slidev-migrate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "slidev-migrate", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install leochiu-a/slidev-workspace slidev-migrate --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/leochiu-a/slidev-workspace.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/slidev-migrate .opencode/skills/slidev-migrate && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "slidev-migrate" agent skill from https://github.com/leochiu-a/slidev-workspace/tree/main/.claude/skills/slidev-migrate into .opencode/skills/slidev-migrate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "slidev-migrate", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: slidev-migrate
GitHub stars: 171
Token cost: ~954 tokens
SKILL.md length: 258 words
Files: 2 (incl. scripts)
Skills in repo: 1
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Migrate a single Slidev project into a Slidev workspace structure.

Works in 4 steps: Validates a Slidev project exists… → Creates slides// with the project files… → Updates the slide's dev script to add… → …
Phrases like migrate to workspace
SKILL.md covers What the migration does, Automated migration…, Manual migration steps and Adding more slides after…, plus 2 more sections
Runs Python scripts from its folder; calls pnpm and python3

What it does

Slidev Migrate is an agent skill from leochiu-a/slidev-workspace. Migrate a single Slidev project into a Slidev workspace structure. Use when the user wants to convert an existing single Slidev project (slides.md + package.json) into a multi-presentation workspace managed by slidev-workspace. Triggers on phrases like "migrate to workspace", "convert to workspace", "set up slidev workspace", "move my slidev to workspace", or any request to organize multiple Slidev presentations under one workspace.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/migrate.py`).

It sits in Documents & Office, covering Slides and decks. It works with npm and pnpm. The repository describes itself as: Slidev Workspace is a specialized command-line tool designed to manage and showcase multiple Slidev presentations. The licence is MIT.

When your agent uses it

Phrases like migrate to workspace
Convert to workspace
Set up slidev workspace
Move my slidev to workspace

Example prompts

“migrate to workspace”
“convert to workspace”
“set up slidev workspace”
“/slidev-migrate”

Requirements

Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Validates a Slidev project exists (slides.md + @slidev/cli in package.json)
Creates slides// with the project files (excluding node_modules, dist, .git)
Updates the slide's dev script to add --base //
Generates root package.json, pnpm-workspace.yaml, and slidev-workspace.yaml

What it can do on your machine

Read from SKILL.md and the folder at commit ab87015. 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
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- pnpm
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.
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

Slidev Migrate loads about 954 tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 258 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from leochiu-a/slidev-workspace at commit ab87015, republished under its MIT licence (© leochiu-a). 258 words, ~954 tokens.

Download SKILL.mdSave it as .claude/skills/slidev-migrate/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: slidev-migrate
description: Migrate a single Slidev project into a Slidev workspace structure. Use when the user wants to convert an existing single Slidev project (slides.md + package.json) into a multi-presentation workspace managed by slidev-workspace. Triggers on phrases like "migrate to workspace", "convert to workspace", "set up slidev workspace", "move my slidev to workspace", or any request to organize multiple Slidev presentations under one workspace.

slidev-migrate

Migrate a single Slidev project to a slidev-workspace structure.

What the migration does

Before:

my-talk/
├── slides.md
├── package.json   (@slidev/cli dependency)
├── components/
└── ...

After:

my-talk-workspace/
├── slides/
│   └── my-talk/          ← original project moved here
│       ├── slides.md
│       ├── package.json   (dev script updated with --base)
│       └── ...
├── package.json           ← new root (slidev-workspace scripts)
├── pnpm-workspace.yaml
└── slidev-workspace.yaml  ← hero/baseUrl config

Automated migration (recommended)

Run the migration script:

bash

python3 .claude/skills/slidev-migrate/scripts/migrate.py \
  --slides-dir <path-to-single-slidev-project> \
  --workspace-name <new-workspace-folder-name> \
  --base-url /<repo-name>

The script:

Validates a Slidev project exists (slides.md + @slidev/cli in package.json)
Creates slides/<project-name>/ with the project files (excluding node_modules, dist, .git)
Updates the slide's dev script to add --base /<folder-name>/
Generates root package.json, pnpm-workspace.yaml, and slidev-workspace.yaml

After running:

bash

cd <workspace-name>
pnpm install
pnpm dev    # starts slidev-workspace preview

Manual migration steps

If the script doesn't fit (e.g., monorepo, in-place migration):

Move the project into slides/<project-name>/
Update the dev script in the slide's package.json:
json
```
"dev": "slidev --base /<project-name>/"
```
Create pnpm-workspace.yaml at workspace root:
yaml
```
packages:
  - "slides/*"
```

Create slidev-workspace.yaml at workspace root:

yaml

hero:
  title: "My Slide Collection"
  description: "Browse all available slide decks"
baseUrl: "/<repo-name>"

Create root package.json:

json

{
  "name": "my-workspace",
  "private": true,
  "type": "module",
  "scripts": {
    "dev": "slidev-workspace preview",
    "build": "slidev-workspace build"
  },
  "devDependencies": {
    "slidev-workspace": "latest"
  }
}

Run pnpm install and pnpm dev

Adding more slides after migration

Add more presentations by placing subdirectories inside slides/. Each needs a slides.md and a package.json with a dev script that includes --base /<folder-name>/.

Key configuration options

slidev-workspace.yaml:

baseUrl — URL base path; must match GitHub repo name for GitHub Pages
hero.title / hero.description — workspace landing page text
sidebar.title / sidebar.githubUrl — sidebar branding
outputDir — build output directory (default: ./dist)
exclude — folder names to skip

Caveats

pnpm catalog: If the slide's package.json uses catalog: versions, the workspace root needs a catalog: section in pnpm-workspace.yaml. Ask the user if they use pnpm catalogs.
In-place migration: If the user wants to convert the current directory (not create a parent workspace), create a slides/ subfolder, move files in, and add the config files at the same root.
Already a workspace: If a pnpm-workspace.yaml or slidev-workspace.yaml already exists, skip workspace creation and only add/update the config files.

Files

SKILL.md and 1 other file (scripts) in .claude/skills/slidev-migrate of leochiu-a/slidev-workspace.

SKILL.md
scripts/migrate.py

Open the folder on GitHubat commit ab87015

Compare with similar skills

Slidev Migrate 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.

Slidev Migrate compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Slidev Migrate this skillleochiu-a/slidev-workspace	171	—	~954	Automated safety check: Pass	MIT	4 days ago
Slidev CLI Skilldskilld-dev/vue-ecosystem-skills	181	—	~1.1k	Automated safety check: Pass	MIT	17 days ago
AI Slidesclaude-office-skills/skills	502	—	~1.4k	Automated safety check: Pass	MIT	8 mo ago
Dashi PPT Presentation Generatorchuspeeism/dashi-ppt-skill	9.3k	—	~3.9k	Automated safety check: Pass	AGPL-3.0	27 days ago
HTML Slide To PPTXmucsbr/ppt-agent-workflow-san	643	—	~1.1k	Automated safety check: Pass	None	1 mo ago
Creatpptseekskyworld/CreatPPT	148	—	~2.7k	Automated safety check: Pass	Apache-2.0	1 mo ago

Similar skills

Slidev CLI Skilld
skilld-dev/vue-ecosystem-skills
Build, present, and ship Slidev decks with @slidev/cli. An agent skill from skilld-dev/vue-ecosystem-skills.
181 GitHub stars~1.1k tokensUpdated 17 days ago
Documents & OfficeAuto-check passed
AI Slides
claude-office-skills/skills
Generate complete presentations with AI - from outline to polished slides
502 GitHub stars~1.4k tokensUpdated 8 mo ago
Documents & OfficeAuto-check passed
Dashi PPT Presentation Generator
chuspeeism/dashi-ppt-skill
Generates browser-editable HTML slide decks from a natural-language brief using preset visual themes, with export to PPTX or PDF.
9.3k GitHub stars~3.9k tokensUpdated 27 days 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.
643 GitHub stars~1.1k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
Creatppt
seekskyworld/CreatPPT
Generate a finished editable Web presentation workspace from a brief or semantic content, then let the user revise it in the browser and explicitly export PPTX on demand.
148 GitHub stars~2.7k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
Kai Slide Creator
wentorai/Research-Claw
Generate zero-dependency HTML presentations that run entirely in the browser.
858 GitHub stars~1k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed

Works with

Questions about Slidev Migrate

What does Slidev Migrate do?

Migrate a single Slidev project into a Slidev workspace structure. Slidev Migrate is an agent skill from leochiu-a/slidev-workspace. Migrate a single Slidev project into a Slidev workspace structure.

When should I use Slidev Migrate?

Slidev Migrate fits situations like: phrases like migrate to workspace; convert to workspace; set up slidev workspace; move my slidev to workspace.

How do I install Slidev Migrate in Claude Code?

Run `npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a claude-code`. Or copy the skill folder (.claude/skills/slidev-migrate in leochiu-a/slidev-workspace) into .claude/skills/slidev-migrate in your project. Claude Code loads it when a task matches its description.

How do I install Slidev Migrate in Codex?

Run `npx skills add leochiu-a/slidev-workspace --skill slidev-migrate -a codex`. Or copy the skill folder (.claude/skills/slidev-migrate in leochiu-a/slidev-workspace) into .agents/skills/slidev-migrate in your project. Codex loads it when a task matches its description.

Can I use Slidev Migrate 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 leochiu-a/slidev-workspace --skill slidev-migrate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/slidev-migrate, .gemini/skills/slidev-migrate, .github/skills/slidev-migrate and .opencode/skills/slidev-migrate in your project.

What does Slidev Migrate need to run?

Going by SKILL.md and its folder, Slidev Migrate needs Python for the scripts in its folder and the command-line tools its instructions call (pnpm and python3). Our summary lists: Python 3.

Does Slidev Migrate 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 Slidev Migrate 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Slidev Migrate use?

Slidev Migrate 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 Slidev Migrate use?

About 954 tokens (SKILL.md is roughly 3.8k 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 Slidev Migrate?

Skills that share tags, products or a category with Slidev Migrate: Slidev CLI Skilld (skilld-dev/vue-ecosystem-skills, 181 stars), AI Slides (claude-office-skills/skills, 502 stars), Dashi PPT Presentation Generator (chuspeeism/dashi-ppt-skill, 9.3k stars) and HTML Slide To PPTX (mucsbr/ppt-agent-workflow-san, 643 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Slidev Migrate?

leochiu-a (a GitHub user) maintains it in leochiu-a/slidev-workspace, which has 171 GitHub stars. The repository was last updated on October 5, 2026.

Source: leochiu-a/slidev-workspace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Slidev Migrate

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

slidev-migrate

What the migration does

Automated migration (recommended)

Manual migration steps

Adding more slides after migration

Key configuration options

Caveats

Files

Compare with similar skills

Similar skills

Slidev CLI Skilld

AI Slides

Dashi PPT Presentation Generator

HTML Slide To PPTX

Creatppt

Kai Slide Creator

Related

Questions about Slidev Migrate