wp-debugging

Diagnose WordPress errors through a phased root-cause analysis workflow.

1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/iwritec0de/wp-dev --skill wp-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-debugging
Source: https://github.com/iwritec0de/wp-dev/tree/main/skills/wp-debugging
Command: npx skills add https://github.com/iwritec0de/wp-dev --skill wp-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WordPress debugging can be chaotic and time-consuming. This skill provides a structured, phase-based methodology to identify root causes of errors, white screens, plugin conflicts, REST API issues, and performance problems.

Core Features & Use Cases

  • Systematic root-cause investigation: enable debugging, read logs, and reproduce issues with minimal changes.
  • Phase-driven workflow: Phase 1 to Phase 4 guide from initial diagnosis to verified fixes, with CLI and server-level checks.
  • Reproducible troubleshooting: combines WP_DEBUG, Query Monitor, SAVEQUERIES, and WP-CLI to isolate faults with auditable steps.
  • Use Case: A developer faces a WSOD after a plugin update and follows the steps to locate the faulty hook.

Quick Start

Describe the WordPress issue you’re facing and I will guide you through a phased debugging workflow to identify and fix the root cause.

Frequently Asked Questions about wp-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a WordPress white screen of death after a plugin update?

Debugging a WordPress WSOD requires a phased root-cause analysis that enables WP_DEBUG, reviews error logs, and uses WP-CLI to isolate the faulty hook causing the conflict. This methodical workflow reproduces issues safely across development, staging, and production contexts.

What is the best way to troubleshoot WordPress REST API issues and 500 errors?

The best way to troubleshoot WordPress REST API issues and 500 errors is a structured workflow combining WP_DEBUG, Query Monitor, and WP-CLI. This phased process isolates faults through auditable diagnostic steps, guiding you from initial reproduction to verified fixes.

How do I systematically find PHP errors in WordPress using WP-CLI?

Finding PHP errors in WordPress with WP-CLI involves a phase-driven diagnostic process that enables debugging flags, inspects server logs, and executes CLI checks. This workflow isolates faults through reproducible troubleshooting steps with minimal system changes.

Can I use this phased debugging workflow for WordPress in a production environment?

Yes, this phased debugging workflow explicitly supports production contexts alongside development and staging environments. It enforces a methodical root-cause analysis process that minimizes system changes while safely diagnosing errors, REST API issues, and plugin conflicts.

Why does my WordPress site break due to plugin conflicts and how do I isolate the fault?

WordPress plugin conflicts cause site failures when hooks interfere, and isolating the fault requires a systematic workflow. By combining WP_DEBUG, SAVEQUERIES, and Query Monitor, this diagnostic process identifies the exact root cause through auditable, step-by-step log reviews.

What should I do when standard WordPress debugging is not working to find the root cause?

When standard WordPress debugging fails to find the root cause, apply a structured four-phase workflow that escalates from WP_DEBUG log reviews to WP-CLI checks and server-level diagnostics. This methodical approach enforces deeper query monitoring to isolate hidden performance problems.