| name | pilotdeck-skills-migration |
| 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. |
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:
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.
- Ask the user which source to migrate before running any migration command.
Use
ask_user_question with these options:
Which skills should I migrate into PilotDeck?
- Claude Code
- OpenClaw
- Hermes
- Custom path
For "Custom path", ask for the source directory path before continuing.
- Run a dry run for only the selected source:
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
-
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.
-
Review the dry-run report with the user, especially conflicts and
validation errors.
-
Copy skills only after confirmation:
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:
npm run skills:migrate -- --from cc,openclaw --execute
npm run skills:migrate -- --from hermes --execute
Handle destination conflicts:
npm run skills:migrate -- --rename --execute
npm run skills:migrate -- --overwrite --execute
Migrate a custom source directory:
npm run skills:migrate -- --source /path/to/skills --execute
Use JSON for scripts or machine-readable reports:
npm run skills:migrate -- --json
Default Sources
The PilotDeck migrator scans immediate child directories containing SKILL.md
from:
- Claude Code:
~/.claude/skills, <project>/.claude/skills
- OpenClaw:
~/.openclaw/workspace/skills,
~/.openclaw/workspace-main/skills,
~/.openclaw/workspace-assistant/skills, ~/.openclaw/skills,
~/.agents/skills
- Hermes:
~/.hermes/skills, ~/.hermes/.claude/skills,
~/.hermes/.agents/skills
Safety Rules
- Always ask which source to migrate first; do not assume all sources.
- If the selected source path is missing, or the dry run reports no
migratable skills, do not execute the migration. Report that nothing was
found.
- Do not delete source skills.
- Prefer
--rename over --overwrite unless the user explicitly wants to
replace existing PilotDeck skills.
- The repo bootstrap syncs this skill into
$PILOT_HOME/skills from
skills/pilotdeck-skills-migration/SKILL.md; it skips existing targets.
