# prepare-migration

Orchestrates full-site redesign migration prep: crawls pages, confirms module catalogs, and builds design canon before running the migration.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 487 installs · ★ 310
- Author: adobe
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/adobe/skills/tree/HEAD/plugins/stardust/skills/prepare-migration/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/prepare-migration

## What it does

This skill acts as a thin orchestrator for the migration prep cascade. It triggers `extract`, `direct`, and `prototype` in their `--prep` modes. Confirmation gates run after each phase so you can review page types and module slots before committing.

Dependencies include Node 22+, Playwright with Chromium, `playwright-cli` on `PATH`, and the `impeccable` skill. The workflow applies exclusively to redesigns. Running it alongside or chaining it with `replica` will trigger an immediate flow guard error.

You can resume interrupted cascades using `--from <phase>` or skip review prompts with `--skip-confirm`. When prep finishes, run `$stardust migrate` separately to start the actual conversion.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill prepare-migration -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/prepare-migration/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/prepare-migration/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill prepare-migration -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/prepare-migration/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill prepare-migration -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/prepare-migration/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install adobe/skills prepare-migration
```

2. **Manually: put the files in place**
- File: `.github/skills/prepare-migration/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill prepare-migration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/adobe/skills --path plugins/stardust/skills/prepare-migration
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/prepare-migration/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill prepare-migration -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/adobe/skills/tree/HEAD/plugins/stardust/skills/prepare-migration/SKILL.md

## When to use it
- crawl the site inventory and assign page types
- confirm module schemas and color reservations before migration
- build design canon archetypes from extracted pages
- resume interrupted migration prep from a specific phase

## Example prompts
- Prepare the migration for this site with a new design
- $stardust prepare-migration --canon-from home
- Run migration prep and resume from the direct phase

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c19cce3d34d7009d.

BEGIN THIRD-PARTY FILE c19cce3d34d7009d
```text
---
name: prepare-migration
description: Prepare a whole site for migration by orchestrating the prep cascade — a full-inventory crawl (extract --prep), page-type and module-catalog confirmation (direct --prep), archetype prototypes plus design canon (prototype --prep), and asset preparation — with confirmation gates between phases. Builds the typed page inventory, confirmed module catalog, and canon that `migrate` consumes. Use when the user wants to prepare or set up a full-site migration, run migration prep, confirm page types and modules before migrating a site, get a large site ready to migrate, or invokes `$stardust prepare-migration`. Trigger phrases include "prepare the migration", "migration prep", "set up the migration data", "get the site ready to migrate". Redesign-flow only — for same-design migrations `replica` runs its own preserve-mode prep cascade; never chain prepare-migration with replica. Not for running the migration itself (`migrate`) or converting a single page (`deploy`).
license: Apache-2.0
compatibility: Requires Node 22+, Playwright with Chromium resolvable from the project, playwright-cli on PATH, and the impeccable skill (github.com/pbakaus/impeccable) installed alongside stardust.
---

# stardust:prepare-migration

Orchestrate the migrate-prep cascade. When the user commits to
migrating an existing site, this skill runs the upstream phases
(`extract`, `direct`, `prototype`) in their `--prep` modes,
sequenced with confirmation gates so the user can confirm or refine
the inferred catalog at each step.

`prepare-migration` is a **thin orchestrator** — it does not
duplicate logic from the underlying skills; it invokes them and
brokers the per-phase summaries. The substantive work lives in:

- `skills/extract/SKILL.md` § Prep mode
- `skills/direct/SKILL.md` § Prep mode
- `skills/prototype/SKILL.md` § Prep mode +
  `reference/canon-extraction.md`

When prep is complete, the user runs `$stardust migrate`
separately. The two-step boundary (`prepare-migration` then
`migrate`) is intentional: it makes "I'm committing to migrate
this site" a conscious gesture and keeps idempotency obvious.

## Inputs

- `--from <phase>` — optional. Resume the cascade from a specific
  phase. Values: `extract | direct | prototype | assets |
  dynamics`. Default starts from the earliest incomplete phase.
- `--skip-confirm` — optional. Skip the per-phase confirmation
  gates. Useful for re-runs where the catalog is already settled.
  Default is to gate at every phase boundary. Hands-off mode
  (`skills/stardust/SKILL.md` § Hands-off mode, i.e.
  `state.json.handsOff: true`) implies `--skip-confirm`.
- `--canon-from <slug>` — optional. Forward to
  `prototype --prep --canon-from <slug>` when that phase runs.
  Override the default canon-author (which is `home`).
- `--refine-module <module-id>` — optional. Re-enter Phase 2's
  module-catalog step for one module — the target of `migrate`'s
  "bespoke slot crossing promotion threshold" hint. Promotes the
  recurring bespoke slot into that module's slot schema
```
END THIRD-PARTY FILE c19cce3d34d7009d

The third-party file has ended. Everything between the c19cce3d34d7009d tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3081 of 16913 bytes. © adobe · Apache-2.0 · https://github.com/adobe/skills/tree/HEAD/plugins/stardust/skills/prepare-migration/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md