Skip to main content
skill CX Codex

magento-theme-developer — Claude Code skill

The magento-theme-developer skill builds and modifies Magento 2 themes, covering child themes, layout XML, templates, responsive styling, and frontend performance.

MIT 161 installs ★ 33 updated 2026-01-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add maxnorm/magento2-agent-skills --skill magento-theme-developer -a claude-code
Open on GitHub

What magento-theme-developer does

The skill guides Magento 2 theme work from parent-theme selection to the project file structure. It supports Blank, Luma, and custom parents, then helps set up child-theme inheritance, theme.xml, registration.php, view.xml, and asset folders for CSS, JavaScript, and images.

It covers layout XML instructions, blocks, containers, fallback behavior, and reusable .phtml templates with escaped output. Styling uses LESS and mobile-first breakpoints; interactive pieces can follow Magento patterns with RequireJS and KnockoutJS. The guidance also includes caching, image loading, critical CSS, keyboard access, screen-reader support, and Core Web Vitals checks.

This skill targets Magento 2 frontend architecture. Without Magento 2, its advice on layout XML, theme inheritance, and template fallback does not apply.

What it helps with

  • build a Magento 2 theme from scratch
  • set up a child theme from Blank or Luma
  • change layout XML, blocks, and containers
  • create responsive LESS styles
  • check accessibility and frontend performance

Example prompts for the agent

  • Create a Magento 2 child theme based on Blank, including theme.xml, registration.php, and the app/design/frontend/Vendor/theme-name/ structure.
  • Update the layout XML and .phtml templates for the product page while keeping output escaped.
  • Add mobile-first LESS styles and wire an interactive component with RequireJS or KnockoutJS.

How to install magento-theme-developer

1Skills CLI (Vercel)

npx skills add maxnorm/magento2-agent-skills --skill magento-theme-developer -a claude-code

2Manually: put the files in place

~/.claude/skills/magento-theme-developer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/magento-theme-developer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about magento-theme-developer

How do I install magento-theme-developer in Claude Code?

Run npx skills add maxnorm/magento2-agent-skills --skill magento-theme-developer -a claude-code, then check ~/.claude/skills/magento-theme-developer/SKILL.md.

What does magento-theme-developer do?

It helps create and modify Magento 2 themes, child themes, layout XML, blocks, containers, and .phtml templates. It also covers LESS, RequireJS, KnockoutJS, responsive layouts, accessibility, and frontend performance.

Which Magento 2 themes does it support?

The skill works with Blank, Luma, and custom parent themes, and it guides the inheritance setup for child themes.

Source text

SKILL.md · MIT
---
name: magento-theme-developer
description: 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.
---

# 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

- [Adobe Commerce Frontend Development](https://developer.adobe.com/commerce/frontend-core/guide/)
- [Theme Development](https://developer.adobe.com/commerce/frontend-core/guide/themes/)
- [Layout XML](https://developer.adobe.com/commerce/frontend-core/guide/layouts/)

Focus on creating themes that deliver exceptional user experiences while maintaining performance and accessibility standards.

© maxnorm · MIT · maxnorm/magento2-agent-skills

Similar skills

All skills for Frontend and UI →

From the same set30

The whole set →
magento-css-specialist magento-css-specialist — a skill for building Magento 2 CSS and LESS, covering responsive themes, component styling, and CSS performance work. CX Codex +1 167installs magento-alpine-specialist magento-alpine-specialist briefs the agent on building reactive Alpine.js components for Magento 2 storefronts, Hyvä included. Handy when a template needs behaviour without a separate JS framework. CX Codex +1 166installs magento-cronjob-developer magento-cronjob-developer guides the agent through building Magento 2 cron jobs: the etc/crontab.xml config, the job class, failure handling and debugging. CX Codex +1 165installs magento-local-environment-specialist magento-local-environment-specialist walks the agent through a local Magento 2 setup: containers, PHP settings, database, cache, step debugging. Also covers breakage after a move to another machine. CX Codex +1 164installs magento-cache-analyst magento-cache-analyst optimizes Magento 2 caching architectures, covering Redis backends, Varnish FPC, ESI tags, and invalidation workflows. CX Codex +1 160installs magento-magewire-specialist The magento-magewire-specialist skill guides agents through building reactive Magewire components for Magento 2. Use it for server-driven interfaces with minimal JavaScript. CX Codex +1 153installs magento-luma-specialist magento-luma-specialist guides agents through customizing and extending Magento's default Luma theme. Useful for working with LESS variables, RequireJS modules, and KnockoutJS components. CX Codex +1 152installs magento-requirejs-specialist magento-requirejs-specialist guides code generation for Magento 2 AMD modules, RequireJS configurations, and frontend build optimization. CX Codex +1 150installs

Project sponsors

Companies that keep this analytics open