magento-performance-analyst — Claude Code skill: Magento
A skill that walks the agent through Magento 2 profiling: finding bottlenecks, reading slow queries, planning optimizations.
npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a claude-codeWhat magento-performance-analyst does
The skill turns the agent into a Magento 2 performance analyst. It covers the whole loop: profile code, database and network, locate the bottlenecks, then build an optimization plan with priorities and a rollback path. Metrics get their own sections — page load time, TTFB, LCP, FID, CLS on the frontend, query execution time, slow query count and cache hit rate on the database side.
Work is split into frontend, database and application. Frontend means Core Web Vitals, trimming JavaScript and CSS, modern image formats. Database means killing N+1 queries, index design, connection pooling, query result caching. Application means PHP execution, memory leaks, caching strategy, lazy loading. Named tools include Blackfire, XHProf, New Relic and browser DevTools.
Measure before you change anything — that is the skill's own rule, and without a baseline every edit is a guess. Profiling needs developer mode: bin/magento deploy:mode:set developer. On a live store that switch is worth testing under load first.
What it helps with
- find the bottleneck behind a slow Magento 2 page
- read slow SQL queries and remove N+1 patterns
- capture baseline metrics before touching code
- build a prioritized optimization plan with rollback
- check the frontend against Core Web Vitals
Example prompts for the agent
- profile this Magento 2 catalog and show where the time goes
- find the slow queries on the product page
- draft an optimization plan ordered by impact
How to install magento-performance-analyst
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a claude-code2Manually: put the files in place
~/.claude/skills/magento-performance-analyst/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/magento-performance-analyst/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a codex2Manually: put the files in place
.agents/skills/magento-performance-analyst/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a cursor2Manually: put the files in place
.cursor/skills/magento-performance-analyst/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install maxnorm/magento2-agent-skills magento-performance-analyst2Manually: put the files in place
.github/skills/magento-performance-analyst/SKILL.md1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a gemini-cli2Platform CLI
gemini skills install https://github.com/maxnorm/magento2-agent-skills --path skills/magento-performance-analystManually: put the files in place
.devin/skills/magento-performance-analyst/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about magento-performance-analyst
How do I install magento-performance-analyst in Claude?
Run npx skills add maxnorm/magento2-agent-skills --skill magento-performance-analyst -a claude-code. The skill file lands at ~/.claude/skills/magento-performance-analyst/SKILL.md.
What does magento-performance-analyst do?
It runs Magento 2 performance analysis: profiling code, database and network, identifying bottlenecks, and planning optimizations with validation.
What do I need for profiling?
The skill relies on developer mode, enabled with bin/magento deploy:mode:set developer, and on tools such as Blackfire, XHProf or New Relic.
Source text
SKILL.md · MIT
--- name: magento-performance-analyst description: Conducts comprehensive Magento 2 performance analysis and optimization. Use when analyzing performance bottlenecks, profiling applications, optimizing database queries, or improving system scalability. Masters profiling tools, database optimization, and enterprise-scale performance tuning. --- # Magento 2 Performance Analyst Expert specialist in conducting comprehensive performance analysis and implementing systematic optimizations that deliver measurable improvements in application speed, scalability, and user experience. ## When to Use - Analyzing performance bottlenecks - Profiling applications - Optimizing database queries - Improving system scalability - Conducting load testing - Optimizing frontend performance ## Performance Analysis ### Profiling Tools - **Blackfire**: Performance profiling and optimization - **XHProf**: PHP profiling tool - **New Relic**: APM monitoring - **Browser DevTools**: Frontend performance analysis - **Database Profiling**: Query profiling and analysis ### Bottleneck Identification - **Code Profiling**: Identify slow functions and performance hotspots - **Database Analysis**: Analyze slow queries and database performance - **Network Analysis**: Identify network latency and bandwidth issues - **Resource Contention**: Identify resource conflicts and bottlenecks - **Third-party Integration**: Analyze external service performance impact ## Performance Optimization Areas ### Frontend Performance - **Core Web Vitals**: Optimize LCP, FID, CLS, and other web vitals - **JavaScript Optimization**: Minimize and optimize JavaScript execution - **CSS Optimization**: Optimize stylesheet delivery and rendering - **Image Optimization**: Modern image formats and responsive loading - **Asset Optimization**: Minimize and compress assets ### Database Optimization - **Query Optimization**: Optimize database queries and eliminate N+1 problems - **Index Strategy**: Design efficient database indexing - **Connection Pooling**: Optimize database connection management - **Query Caching**: Implement query result caching - **Database Tuning**: Tune database configuration for performance ### Application Optimization - **Code Optimization**: Optimize PHP code execution - **Memory Management**: Optimize memory usage and detect leaks - **Caching Strategy**: Implement comprehensive caching strategies - **Resource Management**: Optimize CPU, I/O, and network resources - **Lazy Loading**: Implement lazy loading for expensive operations ## Performance Analysis Process ### 1. Performance Assessment - **Baseline Establishment**: Establish current performance baselines and metrics - **User Experience Analysis**: Analyze real user performance and experience - **System Resource Analysis**: Assess CPU, memory, disk, and network usage - **Application Profiling**: Deep application profiling and code analysis - **Infrastructure Assessment**: Evaluate infrastructure performance and capacity ### 2. Bottleneck Identification - **Code Profiling**: Identify slow functions and performance hotspots - **Database Analysis**: Analyze slow queries and database performance - **Network Analysis**: Identify network latency and bandwidth issues - **Resource Contention**: Identify resource conflicts and bottlenecks - **Third-party Integration**: Analyze external service performance impact ### 3. Optimization Planning - **Priority Matrix**: Prioritize optimizations based on impact and effort - **Resource Planning**: Plan resource requirements for optimizations - **Risk Assessment**: Assess risks associated with performance changes - **Testing Strategy**: Plan comprehensive testing for optimization changes - **Rollback Planning**: Prepare rollback strategies for optimization failures ### 4. Implementation & Validation - **Optimization Implementation**: Implement systematic performance improvements - **Performance Testing**: Validate optimization effectiveness through testing - **Monitoring Setup**: Implement monitoring for sustained performance - **Documentation**: Document optimization changes and performance gains - **Continuous Monitoring**: Establish ongoing performance monitoring ## Performance Metrics ### Key Metrics - **Page Load Time**: Total page load time - **Time to First Byte (TTFB)**: Server response time - **Largest Contentful Paint (LCP)**: Loading performance - **First Input Delay (FID)**: Interactivity - **Cumulative Layout Shift (CLS)**: Visual stability ### Database Metrics - **Query Execution Time**: Database query performance - **Slow Query Count**: Number of slow queries - **Connection Pool Usage**: Database connection efficiency - **Index Usage**: Index effectiveness - **Cache Hit Rate**: Cache performance ## Best Practices ### Optimization Strategy - **Measure First**: Always measure before optimizing - **Prioritize High Impact**: Focus on optimizations with highest impact - **Incremental Approach**: Make incremental improvements - **Test Thoroughly**: Test all optimizations thoroughly - **Monitor Continuously**: Monitor performance continuously ### Scalability Planning - **Horizontal Scaling**: Design for horizontal scaling - **Vertical Scaling**: Optimize for vertical scaling when needed - **Load Balancing**: Implement proper load balancing - **Resource Planning**: Plan for resource growth - **Performance Budgets**: Set and maintain performance budgets ## Tools & Commands ### Profiling Commands ```bash # Enable developer mode for profiling bin/magento deploy:mode:set developer # Check performance bin/magento setup:performance:generate-fixtures # Database status bin/magento setup:db:status ``` ### Monitoring - Set up APM tools (New Relic, Datadog, etc.) - Monitor server resources (CPU, memory, disk) - Track application metrics - Set up alerts for performance degradation ## References - [Adobe Commerce Performance Best Practices](https://developer.adobe.com/commerce/php/best-practices/performance/) - [Performance Testing](https://developer.adobe.com/commerce/php/development/testing/performance/) Focus on systematic performance analysis and optimization that delivers measurable improvements.
© maxnorm · MIT · maxnorm/magento2-agent-skills