migrate-skills-between-libraries — Claude Code skill: migration guide
migrate-skills-between-libraries is a Claude Code skill that moves skills between library workspaces, including when switching from a personal library to a team one.
MIT 158 installs ★ 1,161 updated 2026-09-21
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a claude-codeWhat migrate-skills-between-libraries does
The skill separates two migration paths. Use vendor to copy a locally maintained skill folder; use catalog to add an upstream skill again from its original repository. It starts with a structured inventory of the source library and calls for checking the target for name clashes before importing.
Run mutations with --dry-run first. After importing, rebuild the target documentation with build-docs and run validate. Dependencies listed in requires need their own migration, and collection membership must be added with curate --collection <id>. A vendored copy becomes independent of its source, so changes to one won’t carry over to the other.
What it helps with
- copy a locally maintained skill into another library
- re-catalog a skill from its upstream repository
- check the target workspace for duplicate skill names
- rebuild docs and validate the target after migration
- add migrated skills to a target collection
Example prompts for the agent
- Move the
review-helperskill from/path/to/source-libraryinto the target library as a local copy. - Add the
owner/reposkill to the target from its original repository, and preview the change first. - Check the migrated skill’s dependencies, rebuild the target docs, and validate the library.
How to install migrate-skills-between-libraries
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a claude-code2Manually: put the files in place
~/.claude/skills/migrate-skills-between-libraries/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/migrate-skills-between-libraries/
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a codex2Manually: put the files in place
.agents/skills/migrate-skills-between-libraries/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a cursor2Manually: put the files in place
.cursor/skills/migrate-skills-between-libraries/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MoizIbnYousaf/ai-agent-skills skills/migrate-skills-between-libraries2Manually: put the files in place
.github/skills/migrate-skills-between-libraries/SKILL.md1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a gemini-cli2Platform CLI
gemini skills install https://github.com/MoizIbnYousaf/ai-agent-skills --path skills/migrate-skills-between-librariesManually: put the files in place
.devin/skills/migrate-skills-between-libraries/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about migrate-skills-between-libraries
How do I install migrate-skills-between-libraries in Claude Code?
Run npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a claude-code. The skill file is at ~/.claude/skills/migrate-skills-between-libraries/SKILL.md.
What does migrate-skills-between-libraries do?
It guides skill transfers between library workspaces. Locally maintained folders go through vendor; upstream entries are added again from their original source with catalog.
Do dependencies and collections move with a skill?
Dependencies in requires must be migrated separately. Collection membership does not transfer automatically; add the skill with curate --collection <id>.
Source text
SKILL.md · MIT
--- name: migrate-skills-between-libraries description: Use when moving skills between library workspaces or upgrading from a personal library to a team library. Export from one workspace, import into another. category: workflow version: 4.1.0 --- # 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-run` before any mutating command in the target workspace. - Always use `--list` to inspect the source library before importing. - Always use `--format json` for structured output when scripting migrations. - Never import skills without checking for name collisions in the target workspace first. - Always run `build-docs` in the target workspace after migration. ## Workflow ### Export: Identify skills to migrate from the source library 1. List all skills in the source workspace. ```bash cd /path/to/source-library npx ai-agent-skills list --format json --fields name,tier,workArea,collections ``` 2. For house copies, note the skill folder paths. For upstream picks, note the installSource. ### Import: Add skills to the target workspace 3. For house copies, use `vendor` to copy the skill folder into the target: ```bash 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." ``` 4. For upstream picks, use `catalog` to re-catalog from the original source: ```bash 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." ``` 5. Rebuild docs in the target workspace. ```bash npx ai-agent-skills build-docs ``` 6. Validate the target workspace. ```bash npx ai-agent-skills validate ``` ## Gotchas - Skill names must be unique per workspace. Check for collisions before importing. - House copies are full folder copies — the source and target are independent after migration. - Upstream picks re-catalog from the original upstream source, not the intermediate library. - Dependencies (`requires` field) must also be migrated. Check `info --format json` for each skill's dependency graph. - Collection membership does not transfer automatically. Use `curate --collection <id>` to add migrated skills to target collections.
© MoizIbnYousaf · MIT · MoizIbnYousaf/ai-agent-skills