Skip to main content
skill CX Codex

magento-luma-specialist — Claude Code skill: how to install

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.

MIT 152 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-luma-specialist -a claude-code
Open on GitHub

What magento-luma-specialist does

The skill provides structured guidance for the traditional Magento 2 frontend architecture. It covers parent-child theme inheritance, XML layout modifications, and template overrides.

It standardizes LESS preprocessing using BEM conventions and custom mixins for responsive layouts. In the JavaScript layer, the skill guides RequireJS module configuration, jQuery widget integration, and KnockoutJS observables.

This instruction set targets classic Luma setups exclusively. If your project uses Hyvä or a headless frontend, these guidelines do not apply.

What it helps with

  • create a Magento 2 child theme inheriting from Luma
  • override LESS variables and write responsive mixins
  • configure custom RequireJS modules and dependencies
  • implement KnockoutJS UI components with observable properties

Example prompts for the agent

  • Create a child theme based on Luma and configure theme.xml
  • Override catalog button styles using Luma LESS variables and BEM
  • Build a KnockoutJS component with an observable array for the cart

How to install magento-luma-specialist

1Skills CLI (Vercel)

npx skills add maxnorm/magento2-agent-skills --skill magento-luma-specialist -a claude-code

2Manually: put the files in place

~/.claude/skills/magento-luma-specialist/SKILL.md

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

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

Questions about magento-luma-specialist

How to install magento-luma-specialist in Claude Code?

Run npx skills add maxnorm/magento2-agent-skills --skill magento-luma-specialist -a claude-code in your terminal.

What does magento-luma-specialist do?

It supplies Magento frontend patterns for modifying Luma themes, writing LESS styles, and building KnockoutJS or RequireJS modules.

Which technologies are covered by this skill?

It covers the standard Magento 2 frontend stack: LESS, RequireJS, KnockoutJS, jQuery, and Magento XML layout instructions.

Source text

SKILL.md · MIT
---
name: magento-luma-specialist
description: Customizes and extends Magento's default Luma theme. Use when working with Luma theme, LESS preprocessing, RequireJS modules, KnockoutJS components, or traditional Magento frontend architecture. Masters LESS variables, RequireJS configuration, and responsive design.
---

# Magento 2 Luma Specialist

Expert specialist in creating sophisticated customizations and extensions to Magento's default Luma theme, leveraging traditional Magento frontend technologies while maintaining compatibility and performance.

## When to Use

- Customizing Luma theme
- Working with LESS preprocessing
- Developing RequireJS modules
- Building KnockoutJS components
- Implementing traditional Magento frontend patterns

## Luma Theme Architecture

- **Theme Inheritance**: Master Luma's parent-child theme structure and fallback mechanisms
- **LESS Architecture**: Expert in Luma's LESS variable system and mixins
- **RequireJS Integration**: Advanced module loading and dependency management
- **KnockoutJS Components**: Build dynamic UI components and data binding
- **Layout System**: Deep understanding of XML layout instructions and containers

## Traditional Magento Frontend Stack

- **LESS Preprocessing**: Advanced LESS compilation and optimization
- **RequireJS**: Asynchronous module loading and configuration
- **KnockoutJS**: MVVM pattern implementation for dynamic interfaces
- **jQuery**: Legacy JavaScript functionality and plugin integration
- **UI Components**: Magento's knockout-based UI component library

## Luma Development Process

### 1. Theme Setup & Customization
- **Child Theme Creation**: Set up proper theme inheritance structure
- **Variable Customization**: Modify LESS variables for brand consistency
- **Layout Modifications**: Customize page layouts and component placement
- **Template Overrides**: Create custom template files while maintaining upgradability
- **Asset Organization**: Organize custom CSS, JavaScript, and images

### 2. LESS Development
- **Variable Management**: Efficiently manage theme variables and overrides
- **Mixin Development**: Create custom mixins for repeated patterns
- **Component Styling**: Style individual components with BEM methodology
- **Responsive Patterns**: Implement consistent responsive design patterns
- **Performance Optimization**: Optimize compiled CSS output

### 3. JavaScript Development
- **RequireJS Modules**: Create custom JavaScript modules and widgets
- **KnockoutJS Components**: Build interactive UI components
- **jQuery Integration**: Integrate jQuery plugins and custom functionality
- **Event Handling**: Implement proper event delegation and management
- **AJAX Implementation**: Create seamless AJAX interactions

### 4. UI Components Integration
- **Custom Components**: Build custom UI components using Magento's framework
- **Component Configuration**: Configure existing components for specific needs
- **Data Binding**: Implement sophisticated data binding patterns
- **Validation**: Create custom validation rules and messages
- **Form Handling**: Enhance form functionality and user experience

## LESS Mastery

### Advanced Variables
- Implement complex variable systems and calculations
- Use LESS functions for dynamic values
- Create theme-specific variable overrides
- Manage variable inheritance and scope

### Mixins & Functions
- Create reusable mixins for common patterns
- Use LESS functions for calculations
- Implement responsive mixins
- Build component-specific mixins

## RequireJS Development

### Module Configuration
- Configure RequireJS for optimal loading
- Manage module dependencies
- Create custom module paths
- Optimize module loading order

### Widget Development
- Create Magento widgets
- Implement widget initialization
- Handle widget options and configuration
- Build reusable widget patterns

## KnockoutJS Components

### Component Development
- Build KnockoutJS components
- Implement data binding
- Handle component communication
- Create reusable component patterns

### Data Binding
- Two-way data binding
- Computed observables
- Observable arrays
- Custom bindings

## Best Practices

### Performance
- **Asset Optimization**: Minimize and compress CSS/JS files
- **Lazy Loading**: Implement lazy loading for images and content
- **Caching**: Leverage browser and CDN caching
- **Code Splitting**: Split JavaScript into logical chunks

### Code Organization
- **Modular Structure**: Organize code in logical modules
- **BEM Methodology**: Use BEM for CSS class naming
- **Component Reusability**: Create reusable components
- **Documentation**: Maintain clear documentation

## References

- [Adobe Commerce Frontend Development](https://developer.adobe.com/commerce/frontend-core/guide/)
- [LESS Documentation](http://lesscss.org/)
- [RequireJS Documentation](https://requirejs.org/)
- [KnockoutJS Documentation](https://knockoutjs.com/)

Focus on creating maintainable Luma customizations that leverage Magento's traditional frontend architecture effectively.

© 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-theme-developer The magento-theme-developer skill builds and modifies Magento 2 themes, covering child themes, layout XML, templates, responsive styling, and frontend performance. CX Codex +1 161installs 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-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