# Migrate WordPress Sites with wp-migrate.sh

WordPress migrations can damage data, paths, or URLs when steps are missed. This skill guides preview, backup, migration, rollback, and troubleshooting workflows with wp-migrate.sh.

## Install

```bash
npx skillstore add bwbama85/wp-migrate
```

## Metadata

- Status: approved
- Slug: bwbama85-wp-migrate
- Skillstore revision: r2
- Version status: missing
- Tree hash: 1d06d7463376651cb14933ad9fbd46ec404e999cdbe725a0c4c67be2aca57a03
- Author: BWBama85
- GitHub username: BWBama85
- License: MIT
- Repository: https://github.com/BWBama85/wp-migrate.sh/tree/main/.claude/skills/wp-migrate
- Ref: a39a91716eadede5f4cdefd78178fed4e837a128
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem, scripts, network, env\_access
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/bwbama85-wp-migrate
- Manifest: https://skillstore.pages.dev/api/skills/bwbama85-wp-migrate/manifest

## Capabilities

- Plans push migrations between WordPress servers over SSH.
- Guides imports from Duplicator, Jetpack Backup, and Solid Backups archives.
- Explains dry runs, confirmations, verbose logs, trace output, and quiet automation.
- Supports URL replacement, table prefix alignment, and destination plugin preservation.
- Provides backup discovery, rollback planning, and recovery checks.
- Guides project builds, ShellCheck validation, tests, pull requests, and releases.

## Use Cases

- Move a WordPress site: Preview and run a controlled migration between source and destination servers.
- Automate repeatable deployments: Prepare non-interactive migration workflows with logs, backups, and rollback controls.
- Maintain wp-migrate.sh: Build, test, document, and release changes using the project workflow.

## Prompt Templates

### Preview a push migration

```
Help me preview a WordPress migration from this site to [destination host] at [destination root]. Check prerequisites and use dry-run mode.
```

### Import a backup archive

```
Plan an import from [archive path]. Identify the backup format, required space, destination backups, URL changes, and rollback steps before execution.
```

### Diagnose a failed migration

```
Analyze this migration failure: [error and logs]. Separate source, SSH, archive, database, and filesystem causes. Recommend verification steps before retrying.
```

### Design controlled automation

```
Design a non-interactive wp-migrate.sh workflow for [environment]. Include secret handling, preflight checks, backups, logging, failure recovery, and post-migration validation.
```

## Limitations

- Requires wp-migrate.sh, WP-CLI, SSH access, and relevant archive utilities.
- Does not provide hosting credentials, database secrets, or server permissions.
- Migration and rollback commands can overwrite databases and wp-content.
- Archive guidance is limited to Duplicator, Jetpack Backup, and Solid Backups formats.

## Best Practices

- Start every migration with dry-run and review the complete preview.
- Verify database and wp-content backups before any destructive operation.
- Test rollback and post-migration checks in a safe environment.

## Anti Patterns

- Do not bypass confirmation without independent automation safeguards.
- Do not paste credentials or private key contents into prompts or logs.
- Do not run rollback or cleanup commands from an unverified working directory.

## Security Audit

- Audited at: 2026-07-23T11:51:38.239\+00:00
- Summary: Most static matches are false positives caused by Markdown syntax, repository links, placeholders, and fixed development commands. Confirmed risks include predictable shared temporary paths, a system-wide binary rename during testing, and installation of an unverified remote WP-CLI executable. No prompt injection, credential exfiltration, or malicious intent was found.

## Stats

- Views: 494
- Downloads: 10
- Favorites: 0
- Popularity score: 0