skills/maxnorm/magento2-agent-skills/magento-luma-specialist

magento-luma-specialist

SKILL.md

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

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

Weekly Installs
28
GitHub Stars
6
First Seen
Feb 17, 2026
Installed on
opencode26
codex26
gemini-cli23
github-copilot23
kimi-cli23
cursor23