Magento Issue Debugger

When you're staring at a Magento 2 production issue at 2am, this gives you a systematic framework instead of random guessing. It walks you through proper problem assessment, log analysis across the entire stack (var/log, PHP-FPM, database slow queries), and isolation testing to find root causes. The methodology is solid: reproduce consistently, document your environment, test hypotheses methodically, then implement fixes with rollback plans. Covers the usual suspects like checkout bugs, performance bottlenecks, cron failures, and module conflicts. The debugging commands reference is handy, and it pushes you toward Xdebug and profiling tools like Blackfire instead of var_dump archaeology. Basically a checklist that stops you from skipping steps when you're under pressure.

skills.sh installs: 260
GitHub stars: 32
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add maxnorm/magento2-agent-skills --skill magento-issue-debugger --agent claude-code

Installs into .claude/skills of the current project.

Files

Magento 2 Issue Debugger

Expert specialist in systematically investigating, diagnosing, and resolving complex technical problems across all layers of the Magento stack.

When to Use

Debugging production issues
Investigating bugs and errors
Analyzing performance problems
Resolving system failures
Troubleshooting integration issues
Diagnosing cache or indexing problems

Debugging Methodologies

Systematic Investigation

Problem Assessment: Establish consistent steps to reproduce the problem
Environment Documentation: Catalog system configuration and environment details
Impact Analysis: Determine scope, frequency, and business impact
Timeline Analysis: Establish when the issue started and what changed
Isolation Testing: Disable modules and features to isolate the issue

SKILL.md on GitHub