WordPress Rescue
Free skill for Claude Code · MIT licence
Free skill on GitHub Premium pack, $15, on Agensi
WordPress Rescue is a skill for Claude Code that diagnoses and fixes WordPress errors from the actual debug.log, with a safe rollback procedure. A WordPress site breaks and the owner guesses. A white screen could be a fatal error in a plugin, a memory limit, a broken theme, or a dead database, and each one has a different fix. Guessing from the symptom alone is how a small error becomes a broken site, because the wrong fix gets applied to the wrong cause, and there is no backup to undo it. This skill teaches the agent to read the log first. The log names the file, the file names the plugin or theme, and the error class names the fix.
Who it is for
WordPress site owners and developers who fix broken sites, and anyone who has stared at a white screen and guessed at the cause.
The problem
The site is down and the symptom alone says almost nothing. A fatal error in a plugin, a memory limit, a broken theme, and a dead database can all look the same from the outside, and each one needs a different fix. Without the log, the fix is a guess, and a wrong guess on a live site makes things worse.
What is in the free skill
wordpress-rescue/SKILL.md: the diagnosis-first workflow, the safe rollback procedure, the plugin and theme isolation sequences, a worked example, gotchas, and a troubleshooting table.wordpress-rescue/references/error-decision-tree.md: the full decision tree for ten errors (white screen, database connection, HTTP 500, redirect loops, plugin conflicts, theme conflicts, .htaccess corruption, PHP version and memory limits, file permissions, no log at all). Each entry has the log line, the most likely cause, the fix, and the rollback.wordpress-rescue/INSTALL.md: install steps for Claude Code, Codex CLI, Cursor, and Claude.ai.wordpress-rescue/examples/: four hand-written sample debug.log files (a fatal error in a plugin, a database connection error, a memory exhaustion, and a clean log with warnings only) plus a worked diagnosis of the fatal plugin sample.
Install
git clone https://github.com/WebSmartTools/wordpress-rescue.git mkdir -p ~/.claude/skills cp -r wordpress-rescue ~/.claude/skills/
See wordpress-rescue/INSTALL.md in the repo for Codex CLI, Cursor, and Claude.ai.
How to use it
Ask Claude Code to diagnose the error from the debug.log. The skill reads the log first, names the failing plugin or theme from the file and line, and then follows the safe rollback procedure: back up before any change, make one change at a time, verify after each, and roll back at once if the fix makes it worse.
Premium pack
The premium pack adds the tools that do the diagnosis for you, for $15, one-time payment, single-user licence, on Agensi:
diagnose.py: a script that parses a WordPress debug.log, identifies the failing plugin or theme, the file and line, and the error class, and suggests the fix and the rollback step. Python 3, no dependencies. It also has a--configmode that scanswp-config.php(and a themefunctions.php) for leading or trailing whitespace before<?phpor after?>.rescue.php: a standalone run-once emergency file that disables all plugins and switches to a default theme. Upload it to the site root, visit it in a browser, confirm, then delete it immediately.force-logging-snippet.php: a drop-in snippet forwp-config.phpthat forces PHP errors into a custom log file regardless of server defaults.rollback-checklist.md: the checkbox version of the safe rollback procedure, to run before any fix. The error decision tree is included in the skill copy in this pack.
The free skill stays free, MIT licensed. The premium pack has its own single-user licence and is not open source.
Questions
Which AI tools does it work with?
The skill is written for Claude Code. The repo's INSTALL.md has the install steps for Codex CLI, Cursor, and Claude.ai.
Is the free skill really free?
Yes. The free skill is MIT licensed, free forever. The premium pack is $15, one-time payment, single-user licence, and it is not open source.