---
name: Migrate Skills Between Libraries
slug: migrate-skills-between-libraries
category: AI Engineering
description: Migrate Skills Between Libraries moves skills between AI agent library workspaces using the ai-agent-skills CLI, handling export, import, collision checks, and dependency migration. Use it when upgrading from a personal to a team library or consolidating workspaces.
github: "https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/migrate-skills-between-libraries"
language: JavaScript
stars: 1124
forks: 131
install: "npx degit https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/migrate-skills-between-libraries ~/.claude/skills/migrate-skills-between-libraries"
installs_to: ~/.claude/skills/migrate-skills-between-libraries
source_path: skills/migrate-skills-between-libraries/SKILL.md
collection_size: 18
category_size: 2451
collection_url: "https://dirskills.com/collections/MoizIbnYousaf/Ai-Agent-Skills"
added: 2026-08-20T07:56:26.448Z
last_synced: 2026-08-20T07:56:26.448Z
canonical_url: "https://dirskills.com/skills/migrate-skills-between-libraries"
---

# Migrate Skills Between Libraries

Migrate Skills Between Libraries moves skills between AI agent library workspaces using the ai-agent-skills CLI, handling export, import, collision checks, and dependency migration. Use it when upgrading from a personal to a team library or consolidating workspaces.

**Install:**

```bash
npx degit https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/migrate-skills-between-libraries ~/.claude/skills/migrate-skills-between-libraries
```

## README

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