SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillspilotdeck-skills-migration

pilotdeck-skills-migration

Agents & models

View repository

Updated 10-16 09:49

About this skill

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.

  1. 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.

  1. 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

  1. 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.

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

  3. 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.