magento-cache-analyst — Claude Code skill: setup and features
magento-cache-analyst optimizes Magento 2 caching architectures, covering Redis backends, Varnish FPC, ESI tags, and invalidation workflows.
MIT 160 installs ★ 33 updated 2026-01-24
npx skills add maxnorm/magento2-agent-skills --skill magento-cache-analyst -a claude-codeWhat magento-cache-analyst does
This skill guides coding assistants through Magento 2 cache layer design. It focuses on full-page caching via built-in mechanisms or Varnish, application-level caching for layouts and blocks, and distributed stores like Redis and Memcached.
The workflow moves through four stages: baseline assessment, storage policy design, deployment in files like app/etc/env.php, and load validation. It also includes standard CLI commands for bin/magento cache:*.
Without direct access to the Magento filesystem or server environment, applying the recommended configuration changes is impossible.
What it helps with
- configure a Redis storage backend inside app/etc/env.php
- set up Varnish FPC with Edge Side Includes for dynamic areas
- structure tag-based and event-driven cache invalidation rules
- design automated cache warming routines for catalog pages
Example prompts for the agent
- Configure the default cache backend in
app/etc/env.phpusing Redis. - How do I structure tag-based cache invalidation for Varnish and built-in FPC?
- Draft a cache audit checklist and page warming routine for high-traffic events.
How to install magento-cache-analyst
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-cache-analyst -a claude-code2Manually: put the files in place
~/.claude/skills/magento-cache-analyst/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/magento-cache-analyst/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-cache-analyst -a codex2Manually: put the files in place
.agents/skills/magento-cache-analyst/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-cache-analyst -a cursor2Manually: put the files in place
.cursor/skills/magento-cache-analyst/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install maxnorm/magento2-agent-skills skills/magento-cache-analyst2Manually: put the files in place
.github/skills/magento-cache-analyst/SKILL.md1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-cache-analyst -a gemini-cli2Platform CLI
gemini skills install https://github.com/maxnorm/magento2-agent-skills --path skills/magento-cache-analystManually: put the files in place
.devin/skills/magento-cache-analyst/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-cache-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-cache-analyst
How do I install magento-cache-analyst in Claude Code?
Run npx skills add maxnorm/magento2-agent-skills --skill magento-cache-analyst -a claude-code in your terminal.
What does magento-cache-analyst do?
It gives your agent domain expertise for diagnosing bottlenecks, structuring cache tags, and setting up storage engines in Magento 2.
Which cache engines does it support?
The skill includes patterns for Redis, Memcached, native full-page cache, and Varnish edge setups.
Source text
SKILL.md · MIT
---
name: magento-cache-analyst
description: Optimizes Magento 2 caching strategies for enterprise performance. Use when optimizing cache performance, configuring full-page cache, implementing Redis/Memcached, or designing cache invalidation strategies. Masters FPC, application cache, and distributed caching solutions.
---
# Magento 2 Cache Analyst
Expert specialist in designing and implementing comprehensive caching strategies that dramatically improve application performance while ensuring data consistency and cache coherence across enterprise environments.
## When to Use
- Optimizing cache performance
- Configuring full-page cache (FPC)
- Implementing Redis or Memcached
- Designing cache invalidation strategies
- Troubleshooting cache issues
- Planning cache architecture
## Magento Cache Architecture
- **Cache Types**: Master all Magento cache types and their optimal usage patterns
- **Full Page Cache**: Expert in FPC configuration, ESI holes, and cache warming
- **Application Cache**: Optimize block cache, configuration cache, and layout cache
- **Distributed Caching**: Implement Redis, Memcached, and multi-tier caching
- **Cache Invalidation**: Design efficient cache invalidation and purging strategies
## Cache Types
### Full Page Cache (FPC)
- **Varnish Configuration**: Expert Varnish configuration and VCL optimization
- **Built-in FPC**: Optimize Magento's built-in full-page cache
- **ESI Implementation**: Implement Edge Side Includes for dynamic content
- **Cache Warming**: Automated cache warming and preloading strategies
- **Cache Tags**: Proper cache tag implementation for invalidation
### Application Cache
- **Block Cache**: Cache rendered blocks for faster page generation
- **Configuration Cache**: Cache system and module configurations
- **Layout Cache**: Cache layout XML structures
- **Collection Cache**: Cache frequently accessed collections
- **Object Cache**: Cache expensive object instantiation
### Distributed Caching
- **Redis**: High-performance in-memory data store
- **Memcached**: Distributed memory caching system
- **Multi-tier Caching**: Layer caching for optimal performance
- **Cache Synchronization**: Maintain cache consistency across servers
- **Failover Strategies**: Implement cache failover and recovery
## Cache Optimization Process
### 1. Cache Assessment & Analysis
- **Performance Baseline**: Establish current cache performance metrics
- **Cache Audit**: Analyze existing cache configuration and effectiveness
- **Bottleneck Identification**: Identify cache-related performance bottlenecks
- **Usage Pattern Analysis**: Understand application cache usage patterns
- **Capacity Planning**: Plan cache capacity and resource requirements
### 2. Cache Strategy Design
- **Layered Caching**: Design multi-tier cache architectures
- **Cache Policies**: Define cache TTL, eviction, and invalidation policies
- **Data Segmentation**: Segment cache data for optimal performance
- **Storage Strategy**: Choose appropriate cache storage backends
- **Synchronization Planning**: Plan cache synchronization across environments
### 3. Implementation & Configuration
#### Redis Configuration
```php
// app/etc/env.php
'cache' => [
'frontend' => [
'default' => [
'backend' => 'Cm_Cache_Backend_Redis',
'backend_options' => [
'server' => '127.0.0.1',
'port' => '6379',
'database' => '0',
]
]
]
]
```
#### Cache Commands
```bash
# Clear all cache
bin/magento cache:clean
bin/magento cache:flush
# Enable/disable cache types
bin/magento cache:enable
bin/magento cache:disable
# Cache status
bin/magento cache:status
```
### 4. Testing & Optimization
- **Performance Testing**: Validate cache performance improvements
- **Load Testing**: Test cache behavior under high traffic conditions
- **Cache Warming**: Implement effective cache warming strategies
- **Invalidation Testing**: Test cache invalidation scenarios
- **Monitoring Validation**: Verify monitoring and alerting effectiveness
## Best Practices
### Cache Strategy
- **Cache Hit Ratios**: Maximize cache effectiveness and hit ratios
- **Memory Management**: Optimize cache memory usage and allocation
- **Network Optimization**: Reduce cache-related network overhead
- **Storage Optimization**: Optimize cache storage and persistence strategies
- **Monitoring Integration**: Implement comprehensive cache performance monitoring
### Cache Invalidation
- **Tag-based Invalidation**: Use cache tags for efficient invalidation
- **Event-based Invalidation**: Invalidate cache on relevant events
- **Time-based Expiration**: Set appropriate TTL values
- **Manual Invalidation**: Provide manual cache clearing mechanisms
- **Selective Invalidation**: Invalidate only affected cache entries
### Enterprise Caching
- **CDN Integration**: Optimize CDN caching and edge delivery
- **Multi-server Environments**: Design caching for clustered deployments
- **Cache Synchronization**: Maintain cache consistency across servers
- **Failover Strategies**: Implement cache failover and recovery mechanisms
- **Scalability Planning**: Design caching for horizontal and vertical scaling
## Monitoring
- **Cache Hit Rates**: Monitor cache hit/miss ratios
- **Memory Usage**: Monitor cache memory consumption
- **Performance Metrics**: Track cache-related performance improvements
- **Error Monitoring**: Monitor cache errors and failures
- **Alerting**: Set up alerts for cache issues
## References
- [Adobe Commerce Cache Management](https://developer.adobe.com/commerce/php/development/cache/)
- [Full Page Cache](https://developer.adobe.com/commerce/php/development/cache/page/)
- [Redis Configuration](https://developer.adobe.com/commerce/php/development/cache/partial/redis/)
Focus on creating comprehensive caching strategies that dramatically improve performance while maintaining data consistency.
© maxnorm · MIT · maxnorm/magento2-agent-skills