Agent skill
magento-diagnostic
Comprehensive Magento 2 system diagnostic skill that gathers cache status, index status, module information, configuration, logs, and performance metrics for rapid troubleshooting.
Install this agent skill to your Project
npx add-skill https://github.com/ProxiBlue/claude-skills/tree/main/magento-diagnostic
SKILL.md
This skill automates comprehensive Magento 2 system diagnostics for troubleshooting and performance analysis.
What This Skill Does
-
System Status Check
- Deploy mode (developer/production/default)
- Magento version information
- PHP version and extensions
- Database connection and version
- File system permissions
-
Cache Analysis
- Cache type status (enabled/disabled)
- Cache backend configuration (Redis/File/Database)
- Full Page Cache (FPC) status and backend
- Cache hit/miss rates (if available)
- Cache invalidation history
-
Index Status
- All indexer status and mode (Update on Save/Schedule)
- Index backlog and last update times
- Index lock status
- Changelog table sizes
- Indexer performance metrics
-
Module Information
- Enabled/disabled modules list
- Module version information
- Module dependencies and conflicts
- Custom vs vendor modules
- Recently updated modules
-
Configuration Analysis
- Critical system configurations
- Performance-related settings
- Security configurations
- Multi-store setup details
- Third-party integration status
-
Log Analysis
- Recent error log entries (var/log/system.log)
- Exception log review (var/log/exception.log)
- Debug log analysis (if enabled)
- Web server error logs
- Database slow query logs
-
Performance Metrics
- Current system resource usage
- Queue status and backlog
- Cron job status and schedule
- Recent cron execution logs
- Database table sizes
Bash Commands Used
bin/magento deploy:mode:show
bin/magento cache:status
bin/magento indexer:status
bin/magento module:status
bin/magento config:show
bin/magento cron:list
bin/magento queue:consumers:list
tail -n 100 var/log/system.log
tail -n 100 var/log/exception.log
MCP Integration
Leverages:
- magento2-dev MCP: Magento-specific commands
- database MCP: Database query analysis
- filesystem: Log file reading
Output
The skill provides:
- Executive Summary: High-level system health status
- Critical Issues: Immediate problems requiring attention
- Warnings: Potential issues to monitor
- Performance Report: System performance metrics
- Recommendations: Prioritized action items
Report Format
- Health Score: Overall system health (0-100)
- Issue Classification:
- 🔴 Critical: Immediate action required
- 🟡 Warning: Monitor and plan resolution
- 🟢 Info: System operating normally
- Detailed Findings: Per-category analysis
- Action Plan: Prioritized remediation steps
When to Use
- Initial issue investigation
- Performance troubleshooting
- Before/after deployment validation
- Regular health check monitoring
- Customer-reported issues
- Proactive system maintenance
- Pre-upgrade assessment
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
create-backend-controller
Creates a backend (adminhtml) controller action in Magento 2 with proper ACL, routing, authorization, and admin UI integration. Use when building admin pages, AJAX endpoints, form handlers, or mass actions.
agent-teams
page-banner-setup
hyva-module-compatibility
Identify and fix Magento 2 module compatibility issues with Hyvä Themes. Covers block plugin bypasses, RequireJS/Knockout replacements, ViewModels, and Alpine.js integration for modules that work in admin but fail on Hyvä frontend.
create-frontend-controller
Creates a frontend controller action in Magento 2 for the storefront. Use when building custom frontend pages, AJAX endpoints, form submission handlers, or API-like endpoints for JavaScript.
github-analysis
Systematically analyze GitHub tickets with proper local reproduction. Automatically substitutes production URLs with local DDEV hosts, ensures database sync, downloads missing assets, and reproduces issues locally before proposing solutions.
Didn't find tool you were looking for?