magento-debug

Diagnose Magento 2 issues from symptoms, errors, or logs.

32|3|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/furan917/magento-ai-toolkit --skill magento-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: magento-debug
Source: https://github.com/furan917/magento-ai-toolkit/tree/main/skills/magento-debug
Command: npx skills add https://github.com/furan917/magento-ai-toolkit --skill magento-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix Magento 2 issues from symptoms or errors. Use when debugging white pages, 500 errors, performance issues, or unexpected behaviour.

Core Features & Use Cases

  • Guided diagnosis from symptom to root cause using a structured sequence.
  • Prescribes concrete fixes and verification steps for Magento 2 / Mage-OS environments.
  • Applicable to frontend/backend issues, configuration errors, and performance problems.

Quick Start

Describe the symptom or error and paste it as a system prompt to begin diagnosing and applying fixes.

Frequently Asked Questions about magento-debug

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

FAQPage Schema
How do I debug a white page or 500 error in Magento 2?

Magento 2 white page or 500 error debugging requires analyzing symptoms and logs to find the root cause. A structured diagnostic sequence applies targeted fixes to resolve the unexpected behavior across your deployment environment.

What's the best way to diagnose Magento 2 performance issues?

Diagnosing Magento 2 performance issues involves analyzing symptoms and logs to identify bottlenecks. A structured diagnostic approach prescribes concrete fixes and verification steps to restore optimal deployment performance.

Does this guided Magento troubleshooting work with Mage-OS deployments?

Yes, guided Magento troubleshooting applies to Mage-OS deployments. The diagnostic process analyzes symptoms and logs to apply targeted fixes and verification steps across both Magento 2 and Mage-OS environments.

How do I troubleshoot unexpected behavior in Magento from error logs?

Troubleshooting unexpected Magento behavior from error logs involves pasting the log content as a system prompt. The diagnostic sequence analyzes the errors to determine root causes and apply specific fixes with verification steps.

Can I fix Magento 2 frontend configuration errors using a structured diagnosis?

Yes, you can fix Magento 2 frontend configuration errors using structured diagnosis. The process works through a guided sequence from symptom identification to root cause analysis, applying concrete fixes and verification steps.

Why is Magento debugging not working after applying a fix?

Magento debugging might appear unresolved after applying a fix if verification steps were skipped. The diagnostic process requires verifying the applied fix to ensure the root cause of the original symptom is fully resolved.