WordPress
wp-multisite-migration
Move WordPress multisite sites
Moves a WordPress site between multisite and standalone installs with backups, staged rehearsal, verification, cut-over steps and rollback.
- Area
- WordPress
- Checked against
- WordPress 7.1.2, WP-CLI 2.12.0
- Last verified
- 26 September 2026
- Files
- SKILL.md, 12 references, 3 scripts
How it works
- 1Inventory every install and record tables, users, uploads, plugins, themes and mapping details.
- 2Back up the involved installs and check the backups.
- 3Rehearse the full migration on staging copies.
- 4Prepare and transform copied data for the migration direction.
- 5Preview each write, get approval, run it and verify the result.
- 6Verify tables, users, uploads, URLs, plugins, themes and the rest of the network.
- 7Cut over with DNS and redirects, then keep the previous site available for rollback.
Use it when
- Move a subsite into its own WordPress install.
- Import a standalone site into an existing multisite network.
- Check a partial migration for URLs, roles, media or redirect problems.
How it stays safe
- Starts with
scripts/inventory.shand read-only inspection before planning changes. - Backs up, previews and verifies every write step.
- Transforms copies while keeping the source read-only until cut-over.
- Waits for clear approval before each command marked WRITE.
Install it
Copy the whole wp-multisite-migration folder into your agent's skills folder, not only SKILL.md.
git clone --depth 1 https://github.com/hamzaahmadaslam/agent-skills.git
cp -R agent-skills/wp-multisite-migration "<your agent's skills folder>/"