Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MoizIbnYousaf/ai-agent-skills --skill migrate-skills-between-libraries -a claude-code
Open on GitHub

What 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-helper skill from /path/to/source-library into the target library as a local copy.
  • Add the owner/repo skill 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-code

2Manually: put the files in place

~/.claude/skills/migrate-skills-between-libraries/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/migrate-skills-between-libraries/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →
Northwestern University Libraries Digital Collections API nulib The Northwestern University Libraries Digital Collections API MCP server for Claude Code connects to digitized archives to search records, explore collections, and retrieve IIIF manifests. CX Codex +1 ★ 14repo stars tsdown rolldown tsdown — a skill for bundling TypeScript and JavaScript libraries with Rolldown. Generates type declarations, outputs ESM/CJS, optimizes via tree shaking and minification. CX Codex +1 1,600installs SansFiction hello-uvza SansFiction — an MCP server for finding books, managing a personal library, and tracking reading progress from Claude Code and other supported clients. CX Codex +1 2,590installs golang-popular-libraries samber golang-popular-libraries — a skill to select production-ready Go libraries and frameworks by category (web, database, testing, logging, messaging). Use it when you need to compare alternatives or pick a dependency for a new task. CX Codex +1 41,700installs animated-component-libraries freshtechbro animated-component-libraries helps AI coding agents integrate pre-built animated React components from Magic UI and React Bits. Useful for building landing pages and dashboards without writing custom motion scripts. CX Codex +1 3,200installs scroll-reveal-libraries freshtechbro scroll-reveal-libraries adds lightweight scroll-triggered reveal animations using the AOS library. Useful for marketing pages, documentation, and landing pages that need simple reveal effects. CX Codex +1 2,700installs

From the same set15

The whole set →
browse-and-evaluate The browse-and-evaluate skill helps you find, compare, and inspect catalog skills before adding them. Use it when catalog output needs to stay focused. CX Codex +1 177installs review-a-skill review-a-skill reviews a skill before it enters a library by checking metadata, structure, safety, and dependencies. Use it when the choice is keep, curate, or remove. CX Codex +1 177installs build-workspace-docs build-workspace-docs keeps README.md and WORK_AREAS.md aligned with a skills catalog. Run it after catalog changes or before committing workspace updates. CX Codex +1 172installs audit-library-health audit-library-health — a skill for diagnosing a skills library: validates structure, finds stale elements, checks documentation sync. Run before publishing or updating. CX Codex +1 170installs update-installed-skills update-installed-skills syncs previously installed agent skills to their upstream versions. Helps you inspect changes safely with dry-run flags before overwriting local setups. CX Codex +1 168installs share-a-library share-a-library — a skill that automates publishing a finished local library to GitHub and generates an install command for your teammates. CX Codex +1 161installs install-from-remote-library install-from-remote-library guides safe skill installs from shared repos. Inspects targets via --list and previews every action with a dry-run flag. CX Codex +1 161installs curate-a-team-library curate-a-team-library — a skill for Claude Code, Codex, Cursor and other agents that walks an agent through building a team skills library: mapping shelves, adding entries with curator metadata, assembling a starter pack. CX Codex +1 160installs

Project sponsors

Companies that keep this analytics open