Magento Issue Debugger

The magento-issue-debugger skill is designed to assist AI agents in troubleshooting and resolving specific issues within Magento 2 e-commerce environments. It leverages the platform's diagnostic tools to analyze error logs, configuration files, and system performance metrics to identify root causes.

When to use it

• Diagnosing unexpected checkout failures or payment gateway timeouts during high-traffic periods.
• Investigating database connection errors or slow query performance reported in server logs.
• Resolving theme compatibility issues causing layout breaks on specific product pages.
• Analyzing extension conflicts that result in JavaScript console errors or API request failures.

Key capabilities

• Parses Magento 2 system and var log files to extract relevant error traces.
• Validates XML configuration structures against standard Magento schema requirements.
• Identifies missing dependencies or corrupted cache data contributing to runtime exceptions.
• Correlates specific module versions with known community-reported bugs.

Example prompts

• "Analyze the attached system.log file and explain why the 'Add to Cart' button is throwing a 500 error on the frontend."
• "Check if the current Magento version is compatible with the installed 'Advanced Shipping Rules' extension based on the provided config.xml."
• "Identify potential causes for the database deadlock occurring during the nightly inventory synchronization process."

Tips & gotchas

Ensure you have full read access to the server's log directories before initiating a diagnostic session, as missing permissions will prevent accurate analysis. This skill focuses on technical troubleshooting and may not resolve issues stemming from incorrect business logic or custom code modifications that require manual patching.