# Pilotdeck Skills Migration

Migrate Claude Code, OpenClaw, Hermes, or custom Agent Skill directories into...

- Repository: https://github.com/OpenBMB/PilotDeck (4947 stars)
- Category: AI and agents
- License: AGPL-3.0
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add OpenBMB/PilotDeck --skill pilotdeck-skills-migration -g -a claude-code -y`
Codex: `npx skills add OpenBMB/PilotDeck --skill pilotdeck-skills-migration -g -a codex -y`
Cursor: `npx skills add OpenBMB/PilotDeck --skill pilotdeck-skills-migration -g -a cursor -y`
Gemini CLI: `npx skills add OpenBMB/PilotDeck --skill pilotdeck-skills-migration -g -a gemini-cli -y`

## Description

Migrate Claude Code, OpenClaw, Hermes, or custom Agent Skill directories into PilotDeck's global skills directory. Use when the user asks to migrate, import, copy, or consolidate skills into PilotDeck, or mentions ~/.claude/skills, ~/.openclaw, ~/.hermes, ~/.agents/skills, or ~/.pilotdeck/skills.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# PilotDeck Skills Migration

Use this skill to migrate Agent Skill folders into PilotDeck's global skill
store, `~/.pilotdeck/skills`.

## Workflow

Use the repo npm script from the repo root:

```bash
npm run skills:migrate
```

`npm run dev` runs `predev`, which syncs this repo skill into
`$PILOT_HOME/skills` (`~/.pilotdeck/skills` by default). The migration command
itself stays available as `npm run skills:migrate` without requiring a global
`pilotdeck` command on `PATH`.

1. Ask the user which source to migrate before running any migration command.
   Use `ask_user_question` with these options:

```text
Which skills should I migrate into PilotDeck?
- Claude Code
- OpenClaw
- Hermes
- Custom path
```

For "Custom path", ask for the source directory path before continuing.

2. Run a dry run for only the selected source:

```bash
npm run skills:migrate -- --from cc
npm run skills:migrate -- --from openclaw
npm run skills:migrate -- --from hermes
npm run skills:migrate -- --source /path/to/skills
```

3. If the dry run finds no source path or no migratable skill directories,
   stop. Do not run `--execute`. Tell the user which source was checked and
   that no matching `SKILL.md` directories were found.

4. Review the dry-run report with the user, especially conflicts and
   validation errors.

5. Copy skills only after confirmation:

```bash
npm run skills:migrate -- --from cc --execute
npm run skills:migrate -- --from openclaw --execute
npm run skills:migrate -- --from hermes --execute
npm run skills:migrate -- --source /path/to/skills --execute
```

## Common Commands

Migrate only selected sources:

```bash
npm run skills:migrate -- --from cc,openclaw --execute
npm run skills:migrate -- --from hermes --execute
```

Handle destination conflicts:

```bash
npm run skills:migrate -- --rename --execute
npm run skills:migrate -- --overwrite --execute
```

Migrate a custom source directory:

```bash
npm run skills:migrate -- --source /path/to/skills --execute
```

The rest: https://github.com/OpenBMB/PilotDeck/blob/HEAD/skills/pilotdeck-skills-migration/SKILL.md