Magento 2 Agent Skills

A collection of specialized agent skills for Magento 2 development, designed to provide domain expertise across all aspects of Magento/Adobe Commerce development workflows. These skills are based on the claude-code-magento-agents repository by rubenzantingh, adapted for use as Agent Skills.

Overview

This repository contains 30 specialized skills that enable AI assistants to provide expert-level guidance for Magento 2 development tasks. Each skill focuses on a specific domain within the Magento ecosystem, from core module development to frontend theme implementation, performance optimization, system debugging, infrastructure management, and e-commerce data analysis.

These skills follow the Cursor agent skills format, allowing them to be automatically invoked when relevant development tasks are encountered. The skills can work independently or collaborate hierarchically, with generalist skills delegating to specialists when appropriate.

Available Skills

Core Development

magento-module-developer
Creates robust, maintainable, and extensible Magento 2 modules following enterprise architecture patterns. Handles dependency injection, service contracts, repository patterns, and module architecture. Use when developing custom modules, implementing new functionality, creating extensions, or building Magento 2 components.

magento-feature-developer
Implements complete Magento 2 features from conception to deployment. Coordinates across multiple system layers, integrates with existing functionality, and ensures feature completeness. Use when building new features that span multiple modules or require cross-system integration.

magento-model-developer
Designs and implements data models, entities, and database schemas for Magento 2. Handles entity relationships, data persistence, and model architecture. Use when creating new data entities, designing database schemas, or implementing data access patterns.

magento-code-reviewer
Conducts thorough code reviews for Magento 2 codebases. Evaluates code quality, security, performance, and adherence to Magento coding standards. Use when reviewing pull requests, auditing code quality, or ensuring compliance with development standards.

magento-issue-debugger
Systematically investigates, diagnoses, and resolves complex Magento 2 technical problems. Analyzes logs, profiles performance, and performs root cause analysis. Use when debugging issues, investigating bugs, analyzing performance problems, resolving errors, or troubleshooting system failures.

magento-upgrade-specialist
Manages Magento 2 version upgrades and migrations. Handles compatibility analysis, data migration, and upgrade planning. Use when upgrading Magento versions, migrating between editions, or planning upgrade strategies.

Frontend Development

magento-frontend-developer
Develops complete frontend solutions for Magento 2 storefronts. Handles layout XML, templates, JavaScript, CSS, and frontend architecture. Use when building frontend features, implementing user interfaces, or developing storefront functionality.

magento-hyva-specialist
Develops high-performance Magento 2 storefronts using the Hyvä theme framework. Masters Alpine.js architecture, Tailwind CSS styling, and performance optimization. Use when working with Hyvä themes, Alpine.js, Tailwind CSS, or modern frontend development.

magento-luma-specialist
Develops Magento 2 storefronts using the Luma theme framework. Handles LESS compilation, JavaScript components, and Luma-specific patterns. Use when working with Luma themes, maintaining legacy storefronts, or implementing Luma-based customizations.

magento-theme-developer
Creates and customizes Magento 2 themes from scratch. Handles theme inheritance, layout XML, templates, and styling. Use when creating new themes, customizing existing themes, or implementing theme-level functionality.

magento-ui-component-developer
Develops Magento 2 UI components for admin interfaces. Creates grids, forms, listings, and other admin UI components. Use when building admin interfaces, creating custom UI components, or extending admin functionality.

Backend Development

magento-api-developer
Designs and implements REST and GraphQL APIs for Magento 2. Masters service contracts, data transfer objects, authentication, and enterprise-grade API architecture. Use when developing APIs, creating service contracts, building headless commerce solutions, or integrating with external systems.

magento-cronjob-developer
Develops and maintains Magento 2 cron jobs and scheduled tasks. Handles cron configuration, job scheduling, and background processing. Use when creating scheduled tasks, implementing background jobs, or managing cron-based workflows.

Performance and Security

magento-cache-analyst
Analyzes and optimizes Magento 2 caching strategies. Handles cache types, cache invalidation, and cache performance tuning. Use when optimizing cache performance, debugging cache issues, or implementing custom caching strategies.

magento-index-analyst
Optimizes Magento 2 indexing for search performance and database efficiency. Handles indexer optimization, Elasticsearch configuration, and database indexing strategies. Use when optimizing search performance, configuring Elasticsearch, designing database indexes, or improving reindexing strategies.

magento-performance-analyst
Analyzes and optimizes Magento 2 performance across all system layers. Identifies bottlenecks, optimizes queries, and improves system responsiveness. Use when investigating performance issues, optimizing system speed, or conducting performance audits.

magento-security-analyst
Conducts security audits and implements security best practices for Magento 2. Handles vulnerability assessment, security hardening, and compliance requirements. Use when performing security audits, addressing security vulnerabilities, or implementing security measures.

Language and Technology Specialists

magento-php-specialist
Advanced PHP development for Magento 2 following PSR-12 and Magento coding standards. Masters modern PHP features, object-oriented programming, design patterns, and Magento-specific PHP practices. Use when writing PHP code, implementing business logic, or ensuring code quality.

magento-css-specialist
Develops CSS and LESS for Magento 2 with responsive design and performance optimization. Masters modern CSS techniques, LESS preprocessing, and cross-browser compatibility. Use when styling themes, working with LESS, implementing responsive design, or optimizing CSS performance.

magento-xml-specialist
Creates XML configurations for Magento 2 including layout XML, dependency injection, system configuration, and module definition. Masters XML schema design, validation, and configuration management. Use when working with XML configuration files, layout XML, di.xml, or system.xml.

magento-alpine-specialist
Develops reactive components using Alpine.js for modern Magento 2 frontends. Masters reactive programming, declarative syntax, and lightweight JavaScript solutions. Use when working with Alpine.js, Hyvä themes, or building reactive UI components.

magento-knockout-specialist
Develops reactive UI components using KnockoutJS for Magento 2. Masters observable patterns, data binding, and custom bindings. Use when working with UI components, implementing MVVM patterns, or building interactive frontend features.

magento-magewire-specialist
Develops reactive components using Magewire for Magento 2. Masters component lifecycle, state management, and server-side rendering. Use when building real-time interfaces, creating reactive components, or implementing Livewire-inspired patterns.

magento-requirejs-specialist
Develops AMD modules using RequireJS for Magento 2. Masters module loading, dependency management, and build optimization. Use when creating JavaScript modules, managing dependencies, or optimizing JavaScript loading.

Infrastructure

magento-deployment-engineer
Designs and implements CI/CD pipelines and automated deployments for Magento 2. Masters containerization, orchestration, and scalable deployment strategies. Use when setting up deployment pipelines, automating deployments, managing infrastructure, or implementing DevOps practices.

magento-environment-engineer
Manages Magento 2 environments including development, staging, and production. Masters environment configuration, server management, and environment optimization. Use when setting up environments, configuring servers, managing environments, or troubleshooting environment issues.

magento-local-environment-specialist
Sets up and manages local Magento 2 development environments. Masters local development tools, Docker, and development environment optimization. Use when setting up local development, configuring local environments, or troubleshooting local setup issues.

E-commerce Specialists

magento-catalog-specialist
Analyzes and retrieves catalog information from Magento 2. Masters catalog structure analysis, product data inspection, and catalog diagnostics. Use when analyzing product catalogs, retrieving catalog data, assessing catalog health, or optimizing catalog performance.

magento-configuration-specialist
Analyzes and manages Magento 2 system configuration. Masters configuration analysis, system settings, and configuration optimization. Use when analyzing configuration, retrieving configuration data, managing system settings, or troubleshooting configuration issues.

magento-order-specialist
Analyzes order data and order processing in Magento 2. Masters order lifecycle analysis, payment data inspection, and fulfillment diagnostics. Use when analyzing orders, retrieving order information, assessing order processing performance, or troubleshooting order issues.

Usage

These skills are designed for use with Cursor's agent system. When a development task matches a skill's domain, the skill is automatically invoked to provide specialized guidance.

Skill Structure

Each skill follows a consistent structure:

Frontmatter: Contains skill metadata including name and description
When to Use: Clear guidance on when to invoke the skill
Process Documentation: Step-by-step workflows for common tasks
Best Practices: Industry-standard approaches and recommendations
References: Links to official Magento documentation

Integration with Development Workflows

Skills integrate seamlessly into development workflows:

Identify the development task or problem
The appropriate skill is automatically selected based on context
The skill provides specialized guidance and recommendations
Follow the skill's documented processes and best practices
Skills can delegate to other specialists when needed

Skill Development

Each skill is maintained as a standalone markdown file in the skills/ directory. Skills follow a consistent format that includes:

Clear domain boundaries and use cases
Comprehensive process documentation
Best practices and industry standards
Technical references and documentation links
Practical examples and patterns

When contributing new skills or improving existing ones, maintain consistency with the established format and ensure all technical information is accurate and up-to-date.

Contributing

Contributions are welcome & encouraged!

When contributing:

Follow the existing skill format and structure
Ensure technical accuracy and alignment with Magento best practices
Include appropriate references to official documentation
Test skills in real development scenarios
Maintain clear, concise documentation

If you find inaccuracy in any skills, please create an issue or PR in order to make sure all skils are relevant and follow Magento 2 best pratices

License

This project is licensed under the MIT License. See the LICENSE file for details.