
Magento Theme Developer
- 115 installs
- 26 repo stars
- Updated January 24, 2026
- maxnorm/magento2-agent-skills
magento-theme-developer is an agent skill that guides custom Magento 2 theme and child-theme development—including Luma/Blank inheritance, layout XML, .phtml templates, LESS, and performance optimization—for developers b
About
magento-theme-developer is an agent skill from maxnorm/magento2-agent-skills for end-to-end Magento 2 theme work. It walks through planning (design system review, performance budgets, WCAG targets), base theme selection (Blank or Luma parent), child theme scaffolding under app/design/frontend/Vendor/theme-name with theme.xml, view.xml, web/css, and registration.php, then layout XML containers and blocks, .phtml templates with $escaper output escaping, LESS preprocessing with Magento variables, and RequireJS/KnockoutJS interactions. Specialized coverage includes product and checkout pages, mobile-first responsive breakpoints, Core Web Vitals performance (critical CSS, lazy images, JS payload reduction), and accessibility (ARIA, keyboard navigation, color contrast). Security guidance covers XSS prevention, CSRF form keys, and secure asset handling. Use it for new themes or Luma customizations; pair with magento-knockout-specialist for deep Knockout MVVM component logic.
- Full theme scaffold: theme.xml, view.xml, registration.php, web/css, web/js under app/design/frontend
- Layout XML containers/blocks, .phtml escaping via $escaper, LESS variable system
- Responsive mobile-first breakpoints, Core Web Vitals, critical CSS, lazy loading
- Ecommerce pages: product detail, checkout flow, cart, account, search results
- WCAG accessibility: ARIA labels, keyboard nav, contrast, focus management
Magento Theme Developer by the numbers
- 115 all-time installs (skills.sh)
- +6 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #1,020 of 2,245 Frontend Development skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/maxnorm/magento2-agent-skills --skill magento-theme-developerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 115 |
|---|---|
| repo stars | ★ 26 |
| Last updated | January 24, 2026 |
| Repository | maxnorm/magento2-agent-skills ↗ |
How do you build a custom Magento 2 theme?
Create a Magento 2 child theme with layout XML, .phtml templates, LESS styles, and responsive checkout pages under app/design/frontend.
Who is it for?
Magento 2 developers creating child themes, customizing Luma/Blank storefronts, or implementing responsive ecommerce layouts with layout XML and LESS.
Skip if: Developers only extending Knockout UI component JavaScript without theme files—use magento-knockout-specialist for MVVM component internals.
When should I use this skill?
User develops Magento themes, modifies layout XML or .phtml templates, implements responsive Luma customizations, or optimizes Adobe Commerce frontend performance.
What you get
Theme directory structure, layout XML updates, .phtml templates, LESS/CSS assets, and performance-optimized frontend configuration.
- Child theme directory structure
- Layout XML and .phtml templates
- LESS/CSS and optimized frontend assets
By the numbers
- Theme scaffold includes theme.xml, view.xml, registration.php, and web/css/js under app/design/frontend
- Covers specialized ecommerce surfaces: product pages, checkout flow, cart, account, and search results
Files
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.xml4. 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.
Related skills
How it compares
Use magento-theme-developer for theme files, layout XML, and LESS; use magento-knockout-specialist for Knockout observable and UI component JavaScript.
FAQ
What theme structure does magento-theme-developer use?
magento-theme-developer follows Magento's app/design/frontend/Vendor/theme-name layout with etc/view.xml, web/css and web/js assets, media/preview.jpg, registration.php, and theme.xml declaring parent theme inheritance from Blank or Luma.
Does magento-theme-developer handle KnockoutJS components?
magento-theme-developer covers RequireJS and KnockoutJS at the theme integration level—loading patterns and template hierarchy—but deep MVVM observable work belongs in magento-knockout-specialist from the same skills repository.