Wp Migration Upgrade Review

WordPress migration and upgrade review. Use when reviewing database migrations, option versioning, upgrade routines, data backfills, dbDelta usage, release compatibility, rollback risk, or when user mentions "migration review", "upgrade routine", "dbDelta", "plugin upgrade", "data migration", "version bump", "backfill", "schema change", or "backwards compatibility". Detects unsafe migrations, missing version guards, destructive data changes, and upgrade-flow risks in WordPress code.

116 stars 13 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review
Manual install
git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git /tmp/wordpress-skills
mkdir -p ~/.claude/skills
cp -r /tmp/wordpress-skills/claude-skills/wp-migration-upgrade-review ~/.claude/skills/wp-migration-upgrade-review

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# WordPress Migration and Upgrade Review Skill

## Overview

Systematic review for WordPress plugin and theme upgrade routines. **Core principle:** Upgrades should be repeatable, version-aware, incremental, and safe on real production data. Review covers schema changes, option migrations, version flags, activation upgrades, background backfills, idempotency, rollback risk, and backwards compatibility.

## When to Use

**Use when:**
- Reviewing schema or option migrations
- Auditing `dbDelta()` usage
- Checking versioned upgrade routines
- Reviewing background backfills or one-time repair jobs
- Preparing a risky release for existing installs

**Don't use for:**
- Pure performance review without migration logic
- General plugin architecture review without upgrade context
- One-off content imports unrelated to product upgrades

## Code Review Workflow

1. **Identify migration surface**
   - Activation hook setup
   - Version comparison upgrade routine
   - Background backfill
   - Manual repair tool

2. **Check safety first**
   - Version guard present
   - Routine is idempotent
   - Destructive operations are explicit and justified
   - Large data work is chunked

3. **Review schema and data flow**
   - `dbDelta()` vs raw SQL
   - Option rename/copy/delete order
   - Backfill durability and progress tracking
   - Upgrade completion flags

4. **Apply severity**
   - **CRITICAL:** No version guards, destructive writes without checks, long-running upgrade on page load
Read the full skill on GitHub

Details

Skill name
wp-migration-upgrade-review
Path
claude-skills/wp-migration-upgrade-review/SKILL.md
License
MIT
Repo updated
7 June 2026

FAQ

What does the Wp Migration Upgrade Review skill do?

WordPress migration and upgrade review. Use when reviewing database migrations, option versioning, upgrade routines, data backfills, dbDelta usage, release compatibility, rollback risk, or when user mentions "migration review", "upgrade routine", "dbDelta", "plugin upgrade", "data migration", "version bump", "backfill", "schema change", or "backwards compatibility". Detects unsafe migrations, missing version guards, destructive data changes, and upgrade-flow risks in WordPress code.

How do I install the Wp Migration Upgrade Review skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Wp Migration Upgrade Review popular?

It lives in jorgerosal/wordpress-skills, which has 116 GitHub stars and 13 forks.

Related skills

Wp Accessibility Review

116

jorgerosal/wordpress-skills

WordPress accessibility review for themes, blocks, plugins, and admin interfaces. Use when reviewing keyboard navigation, focus behavior, semantic HTML, ARIA usage, form labeling, screen-reader support, contrast-related implementation issues, or when user mentions "accessibility review", "a11y", "keyboard navigation", "focus management", "screen reader", "ARIA", "semantic HTML", "accessible form", or "accessible block". Detects implementation-level accessibility issues in frontend output, block markup, admin screens, and interactive UI behavior.

Frontend & Design13

Wp Accessibility Review

116

jorgerosal/wordpress-skills

WordPress accessibility review for Codex. Use when reviewing semantic HTML, keyboard access, focus behavior, form labels, ARIA usage, and accessible interaction patterns in themes, blocks, plugins, and admin screens.

Frontend & Design13

Wp Acf and Content Modeling

116

jorgerosal/wordpress-skills

WordPress ACF and content modeling review. Use when reviewing Advanced Custom Fields usage, field group architecture, CPT and taxonomy design, options pages, repeaters, flexible content, block-bound field groups, meta storage patterns, or when user mentions "ACF", "field groups", "flexible content", "repeater", "custom post type design", "taxonomy design", "content model", "relationship fields", "ACF JSON", "options page", or "meta query performance". Detects schema drift, weak content modeling, brittle field naming, and performance issues in meta-heavy WordPress builds.

AI, LLMs & Agents13

Wp Performance Review

116

jorgerosal/wordpress-skills

WordPress performance code review and optimization analysis. Use when reviewing WordPress PHP code for performance issues, auditing themes/plugins for scalability, optimizing WP_Query, analyzing caching strategies, checking code before launch, or detecting anti-patterns, or when user mentions "performance review", "optimization audit", "slow WordPress", "slow queries", "high-traffic", "scale WordPress", "code review", "timeout", "500 error", "out of memory", or "site won't load". Detects anti-patterns in database queries, hooks, object caching, AJAX, template loading, and editor-side performan

AI, LLMs & Agents13

Wp Headless and Wpgraphql

116

jorgerosal/wordpress-skills

Headless WordPress and WPGraphQL review guidance. Use when reviewing decoupled WordPress architectures, WPGraphQL schema design, `register_graphql_field`, `register_graphql_connection`, `graphql_register_types`, Next.js/Gatsby/Remix frontends, preview mode, auth flows, persisted queries, or build/revalidation pipelines. Helps review schema boundaries, resolver performance, preview/auth correctness, cache invalidation, and content modeling decisions for headless WordPress stacks.

AI, LLMs & Agents13

Wp Site Audit and Onboarding

116

jorgerosal/wordpress-skills

WordPress site and codebase onboarding review. Use when inheriting a WordPress repo, auditing an unfamiliar site or project, scoping technical risk before deeper review, identifying whether a codebase is plugin/theme/headless/WooCommerce/multisite/Bedrock/builder-heavy, or when user asks for "site audit", "onboarding review", "what am I looking at", "inherit this WordPress project", "stack discovery", or "where should I start". Produces a prioritized review path and routes follow-up work to the right WordPress skill.

AI, LLMs & Agents13

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.