DO

doncheli-migrate

A structured planning tool for technology migrations with risk-based task waves.

Install

mkdir -p .claude/skills/doncheli-migrate && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14157" && unzip -o skill.zip -d .claude/skills/doncheli-migrate && rm skill.zip

Installs to .claude/skills/doncheli-migrate

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Plan and execute technology migrations with wave planning, breaking change detection and task generation. Activate when user mentions "migrate", "migration", "upgrade", "move from", "switch to", "Vue to React", "JS to TS", "v1 to v2".
234 chars✓ has a “when” trigger
Advanced

Key capabilities

  • Identify source and target technologies for migration
  • Scan codebase to inventory affected modules and dependencies
  • Build an equivalence map between old and new patterns/APIs
  • Detect breaking changes and suggest mitigations
  • Produce a wave plan ordered by risk and dependency graph

How it works

The skill identifies source and target technologies, scans the codebase for affected components, and then generates an equivalence map and detects breaking changes. It then organizes the migration into a phased wave plan with atomic tasks.

Inputs & outputs

You give it
Source stack/version and target stack/version, along with codebase description
You get back
A structured migration plan including equivalence map, breaking changes, and a wave plan

When to use doncheli-migrate

  • Migrating from vue to react
  • Upgrading framework versions
  • Switching languages (JS to TS)
  • Planning infrastructure migrations

About this skill

Don Cheli: Migration Planner

Instructions

  1. Identify source stack/version and target stack/version
  2. Scan the codebase (or description) to inventory affected modules, dependencies, patterns
  3. Build the equivalence map: source construct → target construct
  4. Detect breaking changes (API removals, semantic shifts, config format changes)
  5. Produce a wave plan ordered by risk and dependency graph (low-risk, foundational first)
  6. Generate atomic migration tasks, each independently deployable or reviewable

Output Format

## Migration Plan: <source> → <target>

### Equivalence Map
| Source                  | Target                        | Notes          |
|-------------------------|-------------------------------|----------------|
| <old pattern/API>       | <new pattern/API>             | …              |

### Breaking Changes
1. <change> — Impact: <high/medium/low> — Mitigation: …
…

### Wave Plan
**Wave 1 — Foundation (lowest risk)**
- [ ] Task: …
- [ ] Task: …

**Wave 2 — Core Migration**
- [ ] Task: …

**Wave 3 — Cleanup & Optimization**
- [ ] Task: …

### Rollback Strategy
…

### Definition of Done
- [ ] All tests pass on target stack
- [ ] No references to deprecated source APIs remain
- [ ] Performance benchmarks ≥ baseline

Quality Gate

  • Every breaking change must have an explicit mitigation
  • Wave 1 must be deployable independently without completing later waves
  • If the migration affects >10 files, confirm scope with the user before generating all tasks

Do not use this skill when

  • The change is a minor dependency bump with no API changes (use a standard fix commit)
  • The user only wants to understand differences, not plan tasks (use doncheli-reasoning instead)

When not to use it

  • When the change is a minor dependency bump with no API changes
  • When the user only wants to understand differences, not plan tasks

Limitations

  • Every breaking change must have an explicit mitigation
  • Wave 1 must be deployable independently without completing later waves
  • If the migration affects >10 files, confirm scope with the user before generating all tasks

How it compares

This skill automates the structured planning of technology migrations, including breaking change detection and task generation, which is more systematic than a manual, ad-hoc approach.

Compared to similar skills

doncheli-migrate side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
doncheli-migrate (this skill)04moNo flagsAdvanced
software-architecture3336moNo flagsIntermediate
solid-principles579moNo flagsIntermediate
codex322moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry