Migrate Skills Between Libraries
Use when moving skills between library workspaces or upgrading from a personal library...
Install
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -g -a claude-code -y- Repository
- MoizIbnYousaf/ai-agent-skills1.2k
- Category
- Engineering
- Updated
- 1mo ago
- License
- MIT
- Context cost
- Lightabout 606 tokens
- Runs scripts
- No, instructions only
What it does
Use when moving skills between library workspaces or upgrading from a personal library to a team library. Export from one workspace, import into another.
Migrate Skills Between Libraries
Goal
Move skills from one library workspace to another without losing metadata, breaking dependencies, or duplicating entries.
Guardrails
- Always use
--dry-runbefore any mutating command in the target workspace. - Always use
--listto inspect the source library before importing. - Always use
--format jsonfor structured output when scripting migrations. - Never import skills without checking for name collisions in the target workspace first.
- Always run
build-docsin the target workspace after migration.
Workflow
Export: Identify skills to migrate from the source library
- List all skills in the source workspace.
cd /path/to/source-library
npx ai-agent-skills list --format json --fields name,tier,workArea,collections
- For house copies, note the skill folder paths. For upstream picks, note the installSource.
Import: Add skills to the target workspace
- For house copies, use
vendorto copy the skill folder into the target:
cd /path/to/target-library
npx ai-agent-skills vendor /path/to/source-library --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library." --dry-run
npx ai-agent-skills vendor /path/to/source-library --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library."
- For upstream picks, use
catalogto re-catalog from the original source:
npx ai-agent-skills catalog <owner>/<repo> --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library." --dry-run
npx ai-agent-skills catalog <owner>/<repo> --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library."
- Rebuild docs in the target workspace.
npx ai-agent-skills build-docs
- Validate the target workspace.
npx ai-agent-skills validate
