Agent skill

Wp Migration Upgrade Review

by jorgerosal in jorgerosal/wordpress-skills

WordPress migration and upgrade review. An agent skill from jorgerosal/wordpress-skills.

MITAuto-check passedDatabases

Install Wp Migration Upgrade Review

skills CLI

$ npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install jorgerosal/wordpress-skills wp-migration-upgrade-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude-skills/wp-migration-upgrade-review .claude/skills/wp-migration-upgrade-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "wp-migration-upgrade-review" agent skill from https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review into .claude/skills/wp-migration-upgrade-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wp-migration-upgrade-review", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install jorgerosal/wordpress-skills wp-migration-upgrade-review --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/claude-skills/wp-migration-upgrade-review .agents/skills/wp-migration-upgrade-review && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "wp-migration-upgrade-review" agent skill from https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review into .agents/skills/wp-migration-upgrade-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wp-migration-upgrade-review", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install jorgerosal/wordpress-skills wp-migration-upgrade-review --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/claude-skills/wp-migration-upgrade-review .cursor/skills/wp-migration-upgrade-review && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "wp-migration-upgrade-review" agent skill from https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review into .cursor/skills/wp-migration-upgrade-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wp-migration-upgrade-review", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/jorgerosal/wordpress-skills.git --path claude-skills/wp-migration-upgrade-review

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install jorgerosal/wordpress-skills wp-migration-upgrade-review --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/claude-skills/wp-migration-upgrade-review .gemini/skills/wp-migration-upgrade-review && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "wp-migration-upgrade-review" agent skill from https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review into .gemini/skills/wp-migration-upgrade-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wp-migration-upgrade-review", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install jorgerosal/wordpress-skills wp-migration-upgrade-review

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/claude-skills/wp-migration-upgrade-review .github/skills/wp-migration-upgrade-review && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "wp-migration-upgrade-review" agent skill from https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review into .github/skills/wp-migration-upgrade-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wp-migration-upgrade-review", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install jorgerosal/wordpress-skills wp-migration-upgrade-review --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/jorgerosal/wordpress-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/claude-skills/wp-migration-upgrade-review .opencode/skills/wp-migration-upgrade-review && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "wp-migration-upgrade-review" agent skill from https://github.com/jorgerosal/wordpress-skills/tree/main/claude-skills/wp-migration-upgrade-review into .opencode/skills/wp-migration-upgrade-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wp-migration-upgrade-review", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: wp-migration-upgrade-review
GitHub stars: 103
Token cost: ~1.1k tokens
SKILL.md length: 355 words
Files: 3 (incl. references)
Skills in repo: 35
Repo updated: Jun 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

WordPress migration and upgrade review. An agent skill from jorgerosal/wordpress-skills.

Works in 4 steps: Identify migration surface → Check safety first → Review schema and data flow → …
Reviewing database migrations
SKILL.md covers Overview, When to Use, Code Review Workflow and File-Type Specific Checks, plus 3 more sections
Calls rg

What it does

Wp Migration Upgrade Review is an agent skill from jorgerosal/wordpress-skills. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/schema-and-backfill-guide.md` and `references/versioned-upgrades.md`).

It sits in Databases, covering Database migrations. It works with WordPress. The repository describes itself as: ✅ 🎉 Claude skills and Codex skills for Wordpress development❗️. The licence is MIT.

When your agent uses it

Reviewing database migrations
Option versioning
Upgrade routines
Release compatibility

Example prompts

“migration review”
“upgrade routine”
“dbDelta”
“/wp-migration-upgrade-review”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Identify migration surface
Check safety first
Review schema and data flow
Apply severity

What it can do on your machine

Read from SKILL.md and the folder at commit 8c96442. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- rg
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wp Migration Upgrade Review loads about 1.1k tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 355 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~129
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jorgerosal/wordpress-skills at commit 8c96442, republished under its MIT licence (© jorgerosal). 355 words, ~1,056 tokens.

Download SKILL.mdSave it as .claude/skills/wp-migration-upgrade-review/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: wp-migration-upgrade-review
description: 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.

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

Identify migration surface
- Activation hook setup
- Version comparison upgrade routine
- Background backfill
- Manual repair tool
Check safety first
- Version guard present
- Routine is idempotent
- Destructive operations are explicit and justified
- Large data work is chunked
Review schema and data flow
- dbDelta() vs raw SQL
- Option rename/copy/delete order
- Backfill durability and progress tracking
- Upgrade completion flags
Apply severity
- CRITICAL: No version guards, destructive writes without checks, long-running upgrade on page load
- WARNING: Missing batching, missing rollback consideration, untracked partial state
- INFO: Could use clearer migration registry or logging

File-Type Specific Checks

Versioned Upgrade Routines

CRITICAL: Upgrade logic runs on every request without version compare
WARNING: Multiple migration steps but no ordered upgrade map
INFO: Could centralize migration registry

Show full SKILL.md (129 more words)Show less

Schema Changes

CRITICAL: Raw CREATE TABLE or ALTER TABLE without care for existing installs
WARNING: dbDelta() used without table-version tracking
INFO: Could separate schema and data migration phases

Data Backfills

CRITICAL: Full-table backfill on normal page load
WARNING: No batching or progress option
WARNING: No retry or resumable design
INFO: Could use Action Scheduler or WP-CLI support

Search Patterns for Quick Detection (MIG-21)

Use these rg commands for quick migration scanning.

CRITICAL Patterns

bash

# Version comparisons and upgrade flags
rg -n "version_compare|get_option\s*\(.*version|update_option\s*\(.*version" . -g '*.php'

# Schema changes
rg -n "dbDelta|CREATE TABLE|ALTER TABLE|DROP TABLE" . -g '*.php'

# Activation and upgrade hooks
rg -n "register_activation_hook|upgrader_process_complete|admin_init|init" . -g '*.php'

WARNING Patterns

bash

# Batch candidates and large loops
rg -n "foreach|while" . -g '*.php'

# Background processing and schedulers
rg -n "wp_schedule_event|as_schedule_single_action|WP_CLI" . -g '*.php'

# Delete or rename operations
rg -n "delete_option|rename|migrate|backfill" . -g '*.php'

INFO Patterns

bash

# Upgrade classes or managers
rg -n "Migration|Upgrade|Installer|Schema" . -g '*.php'

Reference Files

references/versioned-upgrades.md - Version flags, ordered migrations, and idempotent upgrade routines
references/schema-and-backfill-guide.md - dbDelta(), table changes, backfills, batching, and release safety

Output Format (MIG-23)

For each finding include severity, file reference, migration risk, and a safe remediation path. Note explicitly if the issue risks production timeouts, partial data state, or irreversible data loss.

Files

SKILL.md and 2 other files (references) in claude-skills/wp-migration-upgrade-review of jorgerosal/wordpress-skills.

SKILL.md
references/schema-and-backfill-guide.md
references/versioned-upgrades.md

Open the folder on GitHubat commit 8c96442

Compare with similar skills

Wp Migration Upgrade Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wp Migration Upgrade Review compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Wp Migration Upgrade Review this skilljorgerosal/wordpress-skills	103	—	~1.1k	Automated safety check: Pass	MIT	4 mo ago
Database Migration Reviewrohitg00/ai-engineering-from-scratch	67k	—	~315	Automated safety check: Pass	MIT	today
Migration Architectalirezarezvani/claude-skills	28k	—	~4.2k	Automated safety check: Pass	MIT	1 mo ago
DB Migrationsericrisco/rsc-harness	180	—	~3.3k	Automated safety check: Pass	MIT	yesterday
Migration Risk AnalyzerMathews-Tom/armory	329	—	~2.5k	Automated safety check: Pass	MIT	5 days ago
Lovableaiskillstore/marketplace	433	1 repos	~2.7k	Automated safety check: Notes	None	yesterday

Similar skills

Database Migration Review
rohitg00/ai-engineering-from-scratch
Reviews database migration files before merge, collecting forward, rollback, locking and data-safety evidence, with a decision that is blocked whenever evidence is missing.
67k GitHub stars~315 tokensUpdated today
DatabasesAuto-check passed
Migration Architect
alirezarezvani/claude-skills
Zero-downtime migration planning, compatibility validation, and rollback strategy generation.
28k GitHub stars~4.2k tokensUpdated 1 mo ago
DatabasesAuto-check passed
DB Migrations
ericrisco/rsc-harness
A skill your agent uses when a schema change must ship without downtime — NOT NULL, rename, type change, or backfilling millions of live rows — for the expand-contract sequence and the lock/batching…
180 GitHub stars~3.3k tokensUpdated yesterday
DatabasesAuto-check passed
Migration Risk Analyzer
Mathews-Tom/armory
Analyzes database migration scripts for lock contention, downtime, rollback strategy, and deployment risk.
329 GitHub stars~2.5k tokensUpdated 5 days ago
DatabasesAuto-check passed
Lovable
aiskillstore/marketplace
Integration skill for Lovable.dev projects. An agent skill from aiskillstore/marketplace.
433 GitHub starsUsed in 1 repo~2.7k tokens
DatabasesAuto-check: notes
Evolving The Data Model
TriliumNext/Trilium
A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…
38k GitHub stars~2.1k tokensUpdated today
DatabasesAuto-check passed

Questions about Wp Migration Upgrade Review

What does Wp Migration Upgrade Review do?

WordPress migration and upgrade review. An agent skill from jorgerosal/wordpress-skills. Wp Migration Upgrade Review is an agent skill from jorgerosal/wordpress-skills. WordPress migration and upgrade review.

When should I use Wp Migration Upgrade Review?

Wp Migration Upgrade Review fits situations like: reviewing database migrations; option versioning; upgrade routines; release compatibility.

How do I install Wp Migration Upgrade Review in Claude Code?

Run `npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a claude-code`. Or copy the skill folder (claude-skills/wp-migration-upgrade-review in jorgerosal/wordpress-skills) into .claude/skills/wp-migration-upgrade-review in your project. Claude Code loads it when a task matches its description.

How do I install Wp Migration Upgrade Review in Codex?

Run `npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a codex`. Or copy the skill folder (claude-skills/wp-migration-upgrade-review in jorgerosal/wordpress-skills) into .agents/skills/wp-migration-upgrade-review in your project. Codex loads it when a task matches its description.

Can I use Wp Migration Upgrade Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jorgerosal/wordpress-skills --skill wp-migration-upgrade-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wp-migration-upgrade-review, .gemini/skills/wp-migration-upgrade-review, .github/skills/wp-migration-upgrade-review and .opencode/skills/wp-migration-upgrade-review in your project.

What does Wp Migration Upgrade Review need to run?

Going by SKILL.md and its folder, Wp Migration Upgrade Review needs the command-line tools its instructions call (rg).

Does Wp Migration Upgrade Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wp Migration Upgrade Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Wp Migration Upgrade Review use?

Wp Migration Upgrade Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wp Migration Upgrade Review use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 234 tokens, read only when the agent opens those files.

What are the alternatives to Wp Migration Upgrade Review?

Skills that share tags, products or a category with Wp Migration Upgrade Review: Database Migration Review (rohitg00/ai-engineering-from-scratch, 67k stars), Migration Architect (alirezarezvani/claude-skills, 28k stars), DB Migrations (ericrisco/rsc-harness, 180 stars) and Migration Risk Analyzer (Mathews-Tom/armory, 329 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wp Migration Upgrade Review?

jorgerosal (a GitHub user) maintains it in jorgerosal/wordpress-skills, which has 103 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on June 7, 2026.

Source: jorgerosal/wordpress-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Wp Migration Upgrade Review

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

WordPress Migration and Upgrade Review Skill

Overview

When to Use

Code Review Workflow

File-Type Specific Checks

Versioned Upgrade Routines

Schema Changes

Data Backfills

Search Patterns for Quick Detection (MIG-21)

CRITICAL Patterns

WARNING Patterns

INFO Patterns

Reference Files

Output Format (MIG-23)

Files

Compare with similar skills

Similar skills

More from jorgerosal/wordpress-skills

Related

Questions about Wp Migration Upgrade Review