{"id":"c4f3564d-3156-4fd2-9b61-3110f501c5f4","shortId":"PwgVnr","kind":"skill","title":"magento-issue-debugger","tagline":"Systematically investigates, diagnoses, and resolves complex Magento 2 technical problems. Use when debugging issues, investigating bugs, analyzing performance problems, resolving errors, or troubleshooting system failures. Masters log analysis, performance profiling, and root ca","description":"# Magento 2 Issue Debugger\n\nExpert specialist in systematically investigating, diagnosing, and resolving complex technical problems across all layers of the Magento stack.\n\n## When to Use\n\n- Debugging production issues\n- Investigating bugs and errors\n- Analyzing performance problems\n- Resolving system failures\n- Troubleshooting integration issues\n- Diagnosing cache or indexing problems\n\n## Debugging Methodologies\n\n### Systematic Investigation\n- **Problem Assessment**: Establish consistent steps to reproduce the problem\n- **Environment Documentation**: Catalog system configuration and environment details\n- **Impact Analysis**: Determine scope, frequency, and business impact\n- **Timeline Analysis**: Establish when the issue started and what changed\n- **Isolation Testing**: Disable modules and features to isolate the issue\n\n### Root Cause Analysis\n- **Hypothesis Testing**: Form and test theories methodically\n- **Data Collection**: Gather logs, configuration, and performance metrics\n- **Code Analysis**: Review recent code changes and related modules\n- **Database Investigation**: Check for data corruption or migration issues\n- **Deep Dive**: Dig deep to find underlying causes rather than treating symptoms\n\n## Issue Investigation Process\n\n### 1. Problem Assessment\n- **Issue Reproduction**: Establish consistent steps to reproduce\n- **Environment Documentation**: Catalog system configuration\n- **Impact Analysis**: Determine scope and business impact\n- **Timeline Analysis**: Establish when issue started\n- **User Impact**: Understand how issue affects different user types\n\n### 2. Data Collection\n- **Log Gathering**: Collect relevant logs from all system components\n  - Magento logs: `var/log/`\n  - PHP error logs\n  - Web server logs (Apache/Nginx)\n  - Database slow query logs\n- **Configuration Review**: Examine module configurations and system settings\n- **Code Analysis**: Review recent code changes and related modules\n- **Database Investigation**: Check for data corruption or migration issues\n- **Performance Metrics**: Gather timing and resource usage data\n\n### 3. Systematic Debugging\n- **Debug Mode**: Enable Magento debug mode for detailed error reporting\n  ```bash\n  bin/magento deploy:mode:set developer\n  ```\n- **Xdebug Integration**: Use step-through debugging for complex logic issues\n- **Profiling Tools**: Use Blackfire, XHProf, or similar tools for performance issues\n- **Database Debugging**: Enable query logging and analyze database interactions\n- **Isolation Testing**: Disable modules to isolate the issue\n\n### 4. Resolution Implementation\n- **Fix Development**: Implement appropriate fixes based on root cause analysis\n- **Testing Strategy**: Develop comprehensive test plans for verification\n- **Rollback Planning**: Prepare rollback procedures for production fixes\n- **Documentation**: Document findings, solutions, and prevention strategies\n- **Monitoring Setup**: Implement monitoring to prevent issue recurrence\n\n## Common Issue Categories\n\n### Performance Issues\n- **Slow Page Loading**: Identify bottlenecks in frontend and backend processing\n- **Database Performance**: Optimize queries, indexes, and database configuration\n- **Memory Issues**: Debug memory leaks and high memory usage\n- **Cache Problems**: Resolve cache invalidation and cache warming issues\n- **Frontend Performance**: Debug JavaScript errors and CSS rendering issues\n\n### Functional Bugs\n- **Checkout Issues**: Debug payment processing, shipping, and order placement\n- **Product Display**: Resolve catalog, search, and product page problems\n- **Admin Panel Issues**: Fix backend functionality and configuration problems\n- **Extension Conflicts**: Identify and resolve module compatibility issues\n- **API Problems**: Debug REST and GraphQL API endpoints\n\n### System-Level Issues\n- **Installation Problems**: Resolve setup and upgrade issues\n- **Configuration Errors**: Fix system and module configuration problems\n- **File Permission Issues**: Resolve file system and directory permission problems\n- **Cron Job Failures**: Debug scheduled task execution problems\n- **Email Issues**: Resolve email sending and template problems\n\n### Security Issues\n- **Access Control**: Debug permission and ACL issues\n- **Authentication Problems**: Resolve login and session issues\n- **CSRF Failures**: Debug form key validation problems\n- **SQL Injection**: Identify and fix vulnerable queries\n- **XSS Vulnerabilities**: Fix output escaping issues\n\n## Debugging Tools & Techniques\n\n### Log Analysis\n- **Magento Logs**: `var/log/exception.log`, `var/log/system.log`\n- **PHP Error Logs**: Check PHP-FPM or Apache error logs\n- **Web Server Logs**: Analyze Apache/Nginx access and error logs\n- **Database Logs**: Review slow query logs and database errors\n- **Custom Logging**: Implement custom logging for specific issues\n\n### Performance Profiling\n- **Blackfire**: Performance profiling and optimization\n- **XHProf**: PHP profiling tool\n- **New Relic**: APM monitoring\n- **Database Profiling**: Enable query logging\n- **Frontend Profiling**: Browser DevTools performance analysis\n\n### Debugging Commands\n```bash\n# Enable developer mode\nbin/magento deploy:mode:set developer\n\n# Clear cache\nbin/magento cache:clean\nbin/magento cache:flush\n\n# Reindex\nbin/magento indexer:reindex\n\n# Check compilation\nbin/magento setup:di:compile\n\n# Check static content\nbin/magento setup:static-content:deploy\n\n# Check database\nbin/magento setup:db:status\n```\n\n### Code Debugging\n- **Xdebug**: Step-through debugging\n- **var_dump/die**: Quick debugging (remove before production)\n- **Magento Logger**: Use `\\Psr\\Log\\LoggerInterface` for logging\n- **Exception Handling**: Proper exception catching and logging\n- **Error Reporting**: Configure error reporting levels\n\n## Best Practices\n\n### Prevention\n- **Comprehensive Testing**: Write unit, integration, and functional tests\n- **Code Reviews**: Regular code reviews to catch issues early\n- **Monitoring**: Implement monitoring and alerting\n- **Logging**: Comprehensive logging strategy\n- **Documentation**: Maintain clear documentation\n\n### Resolution\n- **Root Cause**: Always fix root cause, not symptoms\n- **Testing**: Test fixes thoroughly before deployment\n- **Documentation**: Document the issue and resolution\n- **Communication**: Communicate with stakeholders\n- **Monitoring**: Monitor after fix deployment\n\n## References\n\n- [Adobe Commerce Troubleshooting](https://developer.adobe.com/commerce/php/development/)\n- [Performance Best Practices](https://developer.adobe.com/commerce/php/best-practices/performance/)\n- [Logging](https://developer.adobe.com/commerce/php/development/components/logging/)\n\nFocus on systematic investigation to identify root causes and implement lasting solutions.","tags":["magento","issue","debugger","magento2","agent","skills","maxnorm","agent-skills"],"capabilities":["skill","source-maxnorm","skill-magento-issue-debugger","topic-agent-skills","topic-magento2"],"categories":["magento2-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/maxnorm/magento2-agent-skills/magento-issue-debugger","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add maxnorm/magento2-agent-skills","source_repo":"https://github.com/maxnorm/magento2-agent-skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 9 github stars · SKILL.md body (6,730 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:08:49.446Z","embedding":null,"createdAt":"2026-05-07T20:43:25.950Z","updatedAt":"2026-05-18T19:08:49.446Z","lastSeenAt":"2026-05-18T19:08:49.446Z","tsv":"'/commerce/php/best-practices/performance/)':785 '/commerce/php/development/)':779 '/commerce/php/development/components/logging/)':789 '1':184 '2':12,39,221 '3':281 '4':339 'access':525,584 'acl':530 'across':53 'admin':453 'adob':774 'affect':217 'alert':734 'alway':746 'analysi':32,106,114,135,152,200,207,256,351,563,630 'analyz':21,70,328,582 'apach':576 'apache/nginx':242,583 'api':470,476 'apm':618 'appropri':345 'assess':89,186 'authent':532 'backend':396,457 'base':347 'bash':294,633 'best':710,781 'bin/magento':295,637,644,647,651,656,663,671 'blackfir':314,607 'bottleneck':392 'browser':627 'bug':20,67,434 'busi':111,204 'ca':37 'cach':80,415,418,421,643,645,648 'catalog':99,196,447 'catch':701,727 'categori':385 'caus':134,176,350,745,749,797 'chang':122,156,260 'check':162,266,571,654,660,669 'checkout':435 'clean':646 'clear':642,741 'code':151,155,255,259,675,721,724 'collect':144,223,226 'command':632 'commerc':775 'common':383 'communic':764,765 'compat':468 'compil':655,659 'complex':10,50,308 'compon':232 'comprehens':355,713,736 'configur':101,147,198,247,251,405,460,489,495,706 'conflict':463 'consist':91,190 'content':662,667 'control':526 'corrupt':165,269 'cron':507 'csrf':539 'css':430 'custom':597,600 'data':143,164,222,268,280 'databas':160,243,264,322,329,398,404,588,595,620,670 'db':673 'debug':17,63,84,283,284,288,306,323,408,426,437,472,510,527,541,559,631,676,681,685 'debugg':4,41 'deep':169,172 'deploy':296,638,668,757,772 'detail':104,291 'determin':107,201 'develop':299,343,354,635,641 'developer.adobe.com':778,784,788 'developer.adobe.com/commerce/php/best-practices/performance/)':783 'developer.adobe.com/commerce/php/development/)':777 'developer.adobe.com/commerce/php/development/components/logging/)':787 'devtool':628 'di':658 'diagnos':7,47,79 'differ':218 'dig':171 'directori':504 'disabl':125,333 'display':445 'dive':170 'document':98,195,368,369,739,742,758,759 'dump/die':683 'earli':729 'email':515,518 'enabl':286,324,622,634 'endpoint':477 'environ':97,103,194 'error':25,69,237,292,428,490,569,577,586,596,704,707 'escap':557 'establish':90,115,189,208 'examin':249 'except':697,700 'execut':513 'expert':42 'extens':462 'failur':29,75,509,540 'featur':128 'file':497,501 'find':174,370 'fix':342,346,367,456,491,550,555,747,754,771 'flush':649 'focus':790 'form':138,542 'fpm':574 'frequenc':109 'frontend':394,424,625 'function':433,458,719 'gather':145,225,275 'graphql':475 'handl':698 'high':412 'hypothesi':136 'identifi':391,464,548,795 'impact':105,112,199,205,213 'implement':341,344,377,599,731,799 'index':82,402,652 'inject':547 'instal':482 'integr':77,301,717 'interact':330 'invalid':419 'investig':6,19,46,66,87,161,182,265,793 'isol':123,130,331,336 'issu':3,18,40,65,78,118,132,168,181,187,210,216,272,310,321,338,381,384,387,407,423,432,436,455,469,481,488,499,516,524,531,538,558,604,728,761 'javascript':427 'job':508 'key':543 'last':800 'layer':55 'leak':410 'level':480,709 'load':390 'log':31,146,224,228,234,238,241,246,326,562,565,570,578,581,587,589,593,598,601,624,693,696,703,735,737,786 'logger':690 'loggerinterfac':694 'logic':309 'login':535 'magento':2,11,38,58,233,287,564,689 'magento-issue-debugg':1 'maintain':740 'master':30 'memori':406,409,413 'method':142 'methodolog':85 'metric':150,274 'migrat':167,271 'mode':285,289,297,636,639 'modul':126,159,250,263,334,467,494 'monitor':375,378,619,730,732,768,769 'new':616 'optim':400,611 'order':442 'output':556 'page':389,451 'panel':454 'payment':438 'perform':22,33,71,149,273,320,386,399,425,605,608,629,780 'permiss':498,505,528 'php':236,568,573,613 'php-fpm':572 'placement':443 'plan':357,361 'practic':711,782 'prepar':362 'prevent':373,380,712 'problem':14,23,52,72,83,88,96,185,416,452,461,471,483,496,506,514,522,533,545 'procedur':364 'process':183,397,439 'product':64,366,444,450,688 'profil':34,311,606,609,614,621,626 'proper':699 'psr':692 'queri':245,325,401,552,592,623 'quick':684 'rather':177 'recent':154,258 'recurr':382 'refer':773 'regular':723 'reindex':650,653 'relat':158,262 'relev':227 'relic':617 'remov':686 'render':431 'report':293,705,708 'reproduc':94,193 'reproduct':188 'resolut':340,743,763 'resolv':9,24,49,73,417,446,466,484,500,517,534 'resourc':278 'rest':473 'review':153,248,257,590,722,725 'rollback':360,363 'root':36,133,349,744,748,796 'schedul':511 'scope':108,202 'search':448 'secur':523 'send':519 'server':240,580 'session':537 'set':254,298,640 'setup':376,485,657,664,672 'ship':440 'similar':317 'skill' 'skill-magento-issue-debugger' 'slow':244,388,591 'solut':371,801 'source-maxnorm' 'specialist':43 'specif':603 'sql':546 'stack':59 'stakehold':767 'start':119,211 'static':661,666 'static-cont':665 'status':674 'step':92,191,304,679 'step-through':303,678 'strategi':353,374,738 'symptom':180,751 'system':28,74,100,197,231,253,479,492,502 'system-level':478 'systemat':5,45,86,282,792 'task':512 'technic':13,51 'techniqu':561 'templat':521 'test':124,137,140,332,352,356,714,720,752,753 'theori':141 'thorough':755 'time':276 'timelin':113,206 'tool':312,318,560,615 'topic-agent-skills' 'topic-magento2' 'treat':179 'troubleshoot':27,76,776 'type':220 'under':175 'understand':214 'unit':716 'upgrad':487 'usag':279,414 'use':15,62,302,313,691 'user':212,219 'valid':544 'var':682 'var/log':235 'var/log/exception.log':566 'var/log/system.log':567 'verif':359 'vulner':551,554 'warm':422 'web':239,579 'write':715 'xdebug':300,677 'xhprof':315,612 'xss':553","prices":[{"id":"abdb8813-ba48-46f1-9b56-73d27a26cb41","listingId":"c4f3564d-3156-4fd2-9b61-3110f501c5f4","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"maxnorm","category":"magento2-agent-skills","install_from":"skills.sh"},"createdAt":"2026-05-07T20:43:25.950Z"}],"sources":[{"listingId":"c4f3564d-3156-4fd2-9b61-3110f501c5f4","source":"github","sourceId":"maxnorm/magento2-agent-skills/magento-issue-debugger","sourceUrl":"https://github.com/maxnorm/magento2-agent-skills/tree/main/skills/magento-issue-debugger","isPrimary":false,"firstSeenAt":"2026-05-18T13:14:28.850Z","lastSeenAt":"2026-05-18T19:08:49.446Z"},{"listingId":"c4f3564d-3156-4fd2-9b61-3110f501c5f4","source":"skills_sh","sourceId":"maxnorm/magento2-agent-skills/magento-issue-debugger","sourceUrl":"https://skills.sh/maxnorm/magento2-agent-skills/magento-issue-debugger","isPrimary":true,"firstSeenAt":"2026-05-07T20:43:25.950Z","lastSeenAt":"2026-05-07T22:42:11.389Z"}],"details":{"listingId":"c4f3564d-3156-4fd2-9b61-3110f501c5f4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"maxnorm","slug":"magento-issue-debugger","github":{"repo":"maxnorm/magento2-agent-skills","stars":9,"topics":["agent-skills","magento2"],"license":"mit","html_url":"https://github.com/maxnorm/magento2-agent-skills","pushed_at":"2026-01-24T16:45:35Z","description":"A collection of specialized agent skills for Magento 2 development, designed to provide domain expertise across all aspects of Magento/Adobe Commerce development workflows. ","skill_md_sha":"e147f6ab1af231fa0a34f6c85b66e475ae10d71d","skill_md_path":"skills/magento-issue-debugger/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/maxnorm/magento2-agent-skills/tree/main/skills/magento-issue-debugger"},"layout":"multi","source":"github","category":"magento2-agent-skills","frontmatter":{"name":"magento-issue-debugger","description":"Systematically investigates, diagnoses, and resolves complex Magento 2 technical problems. Use when debugging issues, investigating bugs, analyzing performance problems, resolving errors, or troubleshooting system failures. Masters log analysis, performance profiling, and root cause analysis."},"skills_sh_url":"https://skills.sh/maxnorm/magento2-agent-skills/magento-issue-debugger"},"updatedAt":"2026-05-18T19:08:49.446Z"}}