MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads magento-theme-developer automatically when relevant.

  3. 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

View all →

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.

Frontend & Design857 installs

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.

Security477 installs

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.

Frontend & Design401 installs

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.

Frontend & Design376 installs

Popular frontend & design skills

View category →

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 & Design1.1M installs

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.

OfficialFrontend & Design1M installs

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.

Frontend & Design999.2K installs

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.

Frontend & Design930.5K installs

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.

OfficialFrontend & Design843.1K installs