# Commandkit Legacy Migration

> Migrate existing projects off @commandkit/legacy to modern CommandKit patterns. This skill is migration-only and must not promote new legacy adoption.

- Skill: `neplexlabs/commandkit-legacy-migration` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add neplexlabs/commandkit-legacy-migration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/neplexlabs/commandkit-legacy-migration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: neplexlabs (https://skillmd.com/u/neplexlabs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/neplexlabs/commandkit-legacy-migration

---


# CommandKit Legacy Migration

## Activation guidance

Use only when legacy plugin usage already exists.

## Required filesystem expectations

- legacy and modern structures may coexist during phased migration
- target end state uses `src/app/commands/**` and `src/app/events/**`

## Execution workflow

1. Detect legacy dependencies and plugin usage.
2. Inventory parity requirements.
3. Migrate incrementally by domain/feature slices.
4. Remove `legacy()` only after parity validation.

## Guardrails

- Never recommend new legacy adoption.
- Keep migration commits small and verifiable.

## Reference index

| Name                                       | Description                                             |
| ------------------------------------------ | ------------------------------------------------------- |
| `references/00-filesystem-structure.md`    | Coexistence strategy and target modern structure.       |
| `references/01-legacy-plugin-detection.md` | How to identify legacy plugin and handler usage points. |
| `references/02-migration-plan-template.md` | Stepwise migration plan template with safety checks.    |

## Tool index

| Name  | Description                                      |
| ----- | ------------------------------------------------ |
| `N/A` | This skill currently has no helper tool scripts. |