
magento-theme-developer
Creates custom Magento 2 themes, child themes, and theme modifications. Use when developing themes, customizing frontend, implementing responsive design, or working with Luma/Blank themes. Masters frontend architecture, layout XML, templates, and performance optimization.
- Installs
- 143
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/maxnorm/magento2-agent-skills --skill magento-theme-developer- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads magento-theme-developer automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Magento 2 Theme Developer
Expert specialist in creating stunning, performant, and maintainable themes that deliver exceptional user experiences while adhering to Magento's frontend architecture principles.
When to Use
- Creating custom themes or child themes
- Customizing frontend appearance and layout
- Implementing responsive design
- Working with layout XML and templates
- Optimizing frontend performance
- Modifying existing themes
Theme Development Process
1. Planning & Design Analysis
- Design System Review: Analyze design mockups and create component libraries
- Technical Requirements: Identify custom components and functionality needs
- Performance Goals: Set loading time and performance benchmarks
- Browser Support: Define supported browsers and testing matrix
- Accessibility Standards: Plan for WCAG compliance and screen reader support
2. Theme Architecture Setup
- Base Theme Selection: Choose appropriate parent theme (Blank, Luma, or custom)
- Child Theme Creation: Set up theme inheritance structure
- Asset Organization: Plan CSS, JavaScript, and image file structure
- Build Process: Configure compilation and optimization workflows
- Version Control: Establish theme development and deployment strategies
3. Theme Structure
app/design/frontend/Vendor/theme-name/
├── etc/
│ └── view.xml
├── media/
│ └── preview.jpg
├── web/
│ ├── css/
│ ├── js/
│ └── images/
├── registration.php
└── theme.xml
4. Layout Development
- Page Layouts: Create custom page layouts and page configurations
- Layout Updates: Implement layout XML modifications and customizations
- Block Customization: Customize and extend Magento's block classes
- Container Management: Organize content containers and responsive behavior
- Template Hierarchy: Plan template file organization and reusability
5. Styling Implementation
- Component Styling: Develop modular, reusable CSS components
- Responsive Breakpoints: Implement mobile-first responsive design
- Typography System: Create consistent typography scales and hierarchies
- Color Systems: Implement theme color variables and variations
- Animation & Interactions: Add smooth transitions and micro-interactions
Theme Components
Layout XML
- Master layout instructions, containers, and blocks
- Understand fallback mechanism
- Create custom layout updates
- Manage block and container organization
Template Files (.phtml)
- Create and customize template files
- Use proper output escaping (
$escaper->escapeHtml(), etc.) - Follow template best practices
- Implement proper PHPDoc for template variables
CSS/LESS
- Build responsive, mobile-first stylesheets
- Use LESS preprocessing
- Utilize Magento's LESS variable system
- Optimize CSS for performance
JavaScript
- Implement interactive functionality using RequireJS
- Work with KnockoutJS for dynamic components
- Follow Magento's JS framework patterns
- Optimize JavaScript loading
Specialized Theme Types
E-commerce Themes
- Product Pages: Design compelling product detail and listing pages
- Checkout Flow: Optimize checkout experience for conversion
- Shopping Cart: Create intuitive cart and mini-cart interfaces
- Customer Account: Design user-friendly account management interfaces
- Search Results: Implement effective search and filtering interfaces
Responsive Themes
- Mobile Optimization: Prioritize mobile user experience
- Touch Interactions: Implement touch-friendly navigation and controls
- Performance Budget: Maintain fast loading on mobile networks
- Progressive Enhancement: Ensure functionality across capability ranges
- Viewport Management: Handle various screen sizes and orientations
Accessibility-Focused Themes
- Keyboard Navigation: Ensure full keyboard accessibility
- Screen Reader Support: Implement proper ARIA labels and roles
- Color Contrast: Meet WCAG color contrast requirements
- Focus Management: Create clear focus indicators and logical tab order
- Alternative Text: Provide comprehensive image descriptions
Best Practices
Performance Optimization
- Asset Optimization: Minimize and compress CSS/JS files
- Image Optimization: Use modern image formats and lazy loading
- Critical CSS: Implement critical CSS for faster rendering
- JavaScript Optimization: Minimize JavaScript payload
- Caching: Leverage browser and CDN caching
Code Organization
- Modular Structure: Organize code in logical, maintainable modules
- Template Reusability: Create reusable template components
- CSS Architecture: Use BEM or similar methodology
- JavaScript Modules: Organize JS in RequireJS modules
- Version Control: Use Git effectively for collaborative development
Magento-Specific Patterns
- Layout XML: Master layout instructions and fallback
- UI Components: Work with Magento's UI component library
- LESS Variables: Utilize Magento's LESS variable system
- Theme Inheritance: Properly implement parent-child theme relationships
- Fallback Mechanism: Understand template and layout fallback sequences
Security
- Output Escaping: Always escape output in templates
- XSS Prevention: Proper sanitization of user input
- CSRF Protection: Implement form key validation
- Secure Assets: Serve assets securely
Testing
- Browser Testing: Test across supported browsers
- Responsive Testing: Test on various devices and screen sizes
- Performance Testing: Validate Core Web Vitals
- Accessibility Testing: Test with screen readers and keyboard navigation
- Functional Testing: Ensure all functionality works correctly
References
Focus on creating themes that deliver exceptional user experiences while maintaining performance and accessibility standards.
FAQ
What does the magento-theme-developer skill do?
Creates custom Magento 2 themes, child themes, and theme modifications. Use when developing themes, customizing frontend, implementing responsive design, or working with Luma/Blank themes. Masters frontend architecture, layout XML, templates, and performance optimization.
How do I install magento-theme-developer?
Run npx skills add https://github.com/maxnorm/magento2-agent-skills --skill magento-theme-developer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/magento-theme-developer/ (personal) or .claude/skills/magento-theme-developer/ (project).
Which AI agents can use magento-theme-developer?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is magento-theme-developer safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains magento-theme-developer?
It is published by maxnorm in maxnorm/magento2-agent-skills. It has 143 recorded installs.
More from maxnorm/magento2-agent-skills
magento-hyva-specialist
maxnorm/magento2-agent-skills
Develops high-performance Magento 2 storefronts using Hyvä theme framework. Use when working with Hyvä themes, Alpine.js, Tailwind CSS, or modern frontend development. Masters Alpine.js architecture, Tailwind CSS styling, and performance optimization for blazing-fast e-commerce experiences.
magento-code-reviewer
maxnorm/magento2-agent-skills
Reviews Magento 2 code for quality, security, performance, and compliance with PSR-12 and Magento coding standards. Use proactively when reviewing code, before commits, during pull requests, or when ensuring code quality. Enforces strict type declarations, proper dependency injection, security best practices, and performance optimization.
magento-module-developer
maxnorm/magento2-agent-skills
Creates robust, maintainable, and extensible Magento 2 modules following enterprise architecture patterns. Use when developing custom modules, implementing new functionality, creating extensions, or building Magento 2 components. Masters dependency injection, service contracts, repository patterns, and module architecture.
magento-performance-analyst
maxnorm/magento2-agent-skills
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-frontend-developer
maxnorm/magento2-agent-skills
Creates comprehensive Magento 2 frontend solutions. Use when developing frontend features, working with layout XML, templates, JavaScript, or responsive design. Masters layout XML, template development, JavaScript integration, and performance optimization across all Magento frontend technologies.
magento-xml-specialist
maxnorm/magento2-agent-skills
Creates XML configurations for Magento 2 including layout XML, dependency injection, system configuration, and module definition. Use when working with XML configuration files, layout XML, di.xml, or system.xml. Masters XML schema design, validation, and configuration management.
Popular frontend & design skills
setup-matt-pocock-skills
mattpocock/skills
Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
frontend-design
anthropics/skills
Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
hyperframes-animation
heygen-com/hyperframes
All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.
prototype
mattpocock/skills
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
hyperframes-core
heygen-com/hyperframes
The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.
vercel-react-best-practices
vercel-labs/agent-skills
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.