magento-feature-developer — Claude Code skill for Magento 2
magento-feature-developer is a Claude Code skill for planning Magento 2 business features, including modules, integrations, service contracts, and tests. It supports adding custom behavior or extending an existing store.
MIT 207 installs ★ 33 updated 2026-01-24
npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -a claude-codeWhat magento-feature-developer does
The skill turns feature requirements into a Magento 2 implementation plan. It covers module structure, service interfaces, DTOs, repositories, admin configuration, and connections to external APIs. Ask it to shape a custom product type or outline an order workflow.
Its guidance also covers error handling, access checks, caching, and testing. The test approaches include PHPUnit unit tests, integration checks, and functional scenarios. This is development guidance, not a prebuilt Magento module; implementation still happens in your project.
The skill supports Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. For integrations, it advises accounting for existing modules and contracts, so include those constraints in the requirements you give the agent.
What it helps with
- design a Magento 2 module from business requirements
- add a service contract and repository layer
- connect a third-party API or synchronize data
- plan unit and integration tests for business logic
Example prompts for the agent
- Design a Magento 2 loyalty module with admin settings.
- Plan a third-party API integration and define its service contract.
- Create a test plan for the new order-processing logic.
How to install magento-feature-developer
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -a claude-code2Manually: put the files in place
~/.claude/skills/magento-feature-developer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/magento-feature-developer/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -a codex2Manually: put the files in place
.agents/skills/magento-feature-developer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -a cursor2Manually: put the files in place
.cursor/skills/magento-feature-developer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install maxnorm/magento2-agent-skills skills/magento-feature-developer2Manually: put the files in place
.github/skills/magento-feature-developer/SKILL.md1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -a gemini-cli2Platform CLI
gemini skills install https://github.com/maxnorm/magento2-agent-skills --path skills/magento-feature-developerManually: put the files in place
.devin/skills/magento-feature-developer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -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-feature-developer
How do I install magento-feature-developer in Claude Code?
Run npx skills add maxnorm/magento2-agent-skills --skill magento-feature-developer -a claude-code. The skill file is installed at ~/.claude/skills/magento-feature-developer/SKILL.md.
What does magento-feature-developer do?
It guides Magento 2 feature development, including module design, business logic, service contracts, integrations, and test planning.
What testing approaches does the skill cover?
It includes PHPUnit unit tests, integration checks, functional scenarios, performance testing, and security testing.
Source text
SKILL.md · MIT
--- name: magento-feature-developer description: Implements business requirements as scalable, maintainable Magento 2 features. Use when developing custom functionality, implementing business logic, creating integrations, or building complex features. Masters service contracts, repository patterns, and enterprise-grade feature implementation. --- # Magento 2 Feature Developer Expert specialist in translating business requirements into robust, scalable technical solutions within the Magento ecosystem following Adobe Commerce best practices. ## When to Use - Implementing new business features - Developing custom functionality - Creating integrations with third-party systems - Building complex business logic - Extending existing Magento functionality ## Feature Development Process ### 1. Discovery & Planning - **Requirements Analysis**: Break down business requirements into technical specifications - **Stakeholder Interviews**: Gather comprehensive requirements from business users - **Technical Analysis**: Assess existing system capabilities and constraints - **Impact Assessment**: Evaluate effects on performance, security, and scalability - **Resource Planning**: Estimate development timeline and requirements ### 2. Architecture Design - **System Design**: Create high-level architecture diagrams and component relationships - **Database Design**: Plan entity relationships, indexes, and data migration strategies - **API Design**: Define service contracts and data transfer objects - **Integration Points**: Identify touchpoints with existing modules and third-party systems - **Performance Planning**: Design for scalability and optimal response times ### 3. Implementation Strategy - **Module Structure**: Organize code following Magento's module conventions - **Service Contracts**: Implement clean API interfaces for feature contracts - **Repository Pattern**: Build data access layers using Magento's repository pattern - **Configuration Management**: Implement admin configuration options where appropriate - **Error Handling**: Build robust error handling and logging mechanisms ### 4. Quality Assurance - **Unit Testing**: Write comprehensive PHPUnit tests for business logic - **Integration Testing**: Test feature integration with core Magento functionality - **Performance Testing**: Ensure features don't degrade system performance - **Security Review**: Validate security compliance and data protection ## Common Feature Types ### E-commerce Features - **Custom Product Types**: Implement specialized product configurations - **Pricing Rules**: Build complex pricing and discount logic - **Inventory Management**: Create advanced inventory tracking and allocation - **Order Processing**: Implement custom order workflows and fulfillment - **Customer Features**: Build loyalty programs, wishlists, and customer dashboards ### Administrative Features - **Reporting & Analytics**: Create custom reports and data visualization - **Bulk Operations**: Implement mass actions and data import/export - **Workflow Automation**: Build automated business processes - **Content Management**: Create custom content types and management interfaces - **User Management**: Implement role-based access and permission systems ### Integration Features - **Third-party APIs**: Connect with external services and platforms - **Data Synchronization**: Build real-time or batch data sync processes - **Webhook Integration**: Implement event-driven integrations - **File Processing**: Handle document uploads, processing, and storage - **Notification Systems**: Build email, SMS, and push notification features ## Development Patterns ### Service Contracts - Create interfaces in `Api/` directory - Implement clean API interfaces - Use data transfer objects (DTOs) for data exchange - Maintain backward compatibility ### Repository Pattern - Separate data access from business logic - Use repositories for all data operations - Implement proper error handling - Support transactions where needed ### Event/Observer Pattern - Dispatch events for extensibility - Implement observers for loose coupling - Use proper event naming conventions - Document event data structure ### Plugin System - Use plugins to extend functionality - Prefer before/after plugins over around plugins - Document plugin execution order ## Best Practices ### Code Organization - **Modular Design**: Keep features self-contained within dedicated modules - **Interface Segregation**: Use small, focused interfaces - **Dependency Injection**: Leverage Magento's DI container - **Configuration Management**: Use XML configurations for flexibility - **Namespace Organization**: Follow PSR-4 autoloading standards ### Performance Considerations - **Lazy Loading**: Implement lazy loading for expensive operations - **Caching Strategy**: Utilize appropriate cache types - **Database Optimization**: Use efficient queries and proper indexing - **Frontend Optimization**: Minimize JavaScript/CSS footprint - **Resource Management**: Monitor memory usage and execution time ### Security - **Input Validation**: Implement comprehensive input validation - **Output Escaping**: Ensure proper output sanitization - **CSRF Protection**: Implement form key validation - **Access Control**: Enforce proper permission checking - **Data Encryption**: Handle sensitive data appropriately ### Maintenance & Extensibility - **Backward Compatibility**: Ensure features work across Magento version upgrades - **Extension Points**: Provide hooks for other developers to extend features - **Configuration Options**: Allow customization without code modifications - **Migration Scripts**: Provide smooth upgrade paths - **Documentation**: Maintain comprehensive technical and user documentation ## Testing Strategy - **Unit Tests**: Test individual classes and methods - **Integration Tests**: Test module integration with core - **Functional Tests**: End-to-end test scenarios - **Performance Tests**: Validate performance under load - **Security Tests**: Test authentication, authorization, and data protection ## References - [Adobe Commerce Extension Development](https://developer.adobe.com/commerce/php/development/) - [Best Practices](https://developer.adobe.com/commerce/php/best-practices/) - [Service Contracts](https://developer.adobe.com/commerce/php/development/components/service-contracts/) Focus on creating features that meet immediate business needs while providing a foundation for future growth and customization.
© maxnorm · MIT · maxnorm/magento2-agent-skills