Skip to main content
skill CX Codex

magento-alpine-specialist — Claude Code skill: Alpine.js for Magento 2

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.

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

What magento-alpine-specialist does

Frontend work on Magento 2 has its own constraints, and this skill puts them in front of the agent before it writes markup: Alpine directives, state kept in attributes, event handling, splitting a widget into reusable pieces instead of one giant component.

The Magento side gets its own section — theme integration, Hyvä compatibility, data from REST and GraphQL, cache-friendly output, and keeping SEO markup intact. Those are the things that usually break when someone drops JavaScript into a .phtml template.

The install drops a single SKILL.md at ~/.claude/skills/magento-alpine-specialist/SKILL.md. No scripts to run, just instructions. Which means whatever the agent writes goes into your theme unchanged, and testing it against real templates and block cache is on you.

What it helps with

  • Build a product filter that refreshes results with no page reload
  • Move a checkout block onto Hyvä without breaking block caching
  • Feed GraphQL product data into a reactive widget
  • Split an oversized Alpine component into reusable pieces
  • Keep SEO markup working inside an interactive block

Example prompts for the agent

  • Build a product filter with Alpine.js for our Hyvä theme, pull the data from GraphQL
  • Rewrite this block using x-data and x-show so the state sits in the markup
  • Check the cart template: quantity changes should happen without a reload

How to install magento-alpine-specialist

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about magento-alpine-specialist

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

Run npx skills add maxnorm/magento2-agent-skills --skill magento-alpine-specialist -a claude-code. The skill lands at ~/.claude/skills/magento-alpine-specialist/SKILL.md.

What is magento-alpine-specialist?

A skill file that tells the agent how to build reactive Alpine.js components for Magento 2: directives, data binding, events, plus REST and GraphQL integration.

Does it work with Hyvä themes?

Yes. Hyvä compatibility is covered as its own block, next to general integration with Magento themes, so Alpine components fit either setup.

Source text

SKILL.md · MIT
---
name: magento-alpine-specialist
description: Develops reactive components using Alpine.js for modern Magento 2 frontends. Use when working with Alpine.js, Hyvä themes, or building reactive UI components. Masters reactive programming, declarative syntax, and lightweight JavaScript solutions.
---

# Magento 2 Alpine.js Specialist

Expert specialist in creating modern, reactive user interfaces for Magento 2 applications using Alpine.js's declarative approach.

## When to Use

- Building Alpine.js components
- Working with Hyvä themes
- Creating reactive UI components
- Implementing lightweight JavaScript solutions
- Building interactive frontend features

## Alpine.js Mastery

### Reactive Programming
- **Reactive Data**: Expert in Alpine.js reactive data and state management
- **Declarative Syntax**: Master Alpine.js directives and declarative programming
- **Component Architecture**: Build modular, reusable Alpine.js components
- **Data Binding**: Two-way data binding and reactive updates
- **Event Handling**: Advanced event handling and user interaction patterns

### Component Development
```html
<div x-data="{ open: false, items: [] }">
    <button @click="open = !open">Toggle</button>
    <div x-show="open" x-transition>
        Content here
    </div>
</div>
```

### Magento Integration
- **Theme Integration**: Seamless integration with Magento themes
- **Hyvä Compatibility**: Expert integration with Hyvä theme framework
- **API Integration**: Connection with Magento REST and GraphQL APIs
- **Cache Compatibility**: Cache-friendly Alpine.js implementations
- **SEO Optimization**: SEO-friendly reactive component development

## Best Practices

- **Lightweight**: Keep components lightweight and performant
- **Reactive State**: Use reactive state management effectively
- **Event Handling**: Implement proper event handling
- **Performance**: Optimize for performance
- **Accessibility**: Ensure accessibility compliance

## References

- [Alpine.js Documentation](https://alpinejs.dev/)
- [Hyvä Theme](https://hyva.io/)

Focus on creating lightweight, reactive components that enhance user experience.

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

Similar skills

All skills for Frontend and UI →

From the same set30

The whole set →
magento-upgrade-specialist magento-upgrade-specialist — a skill for Magento 2 upgrades, Magento 1 migrations, compatibility checks, and breaking-change planning across custom code and extensions. CX Codex +1 176installs magento-knockout-specialist magento-knockout-specialist guides coding agents in building reactive KnockoutJS UI components and MVVM patterns for Magento 2. CX Codex +1 168installs magento-environment-engineer The magento-environment-engineer skill helps manage Magento 2 across development, staging, production, and testing environments. Use it for server configuration and environment troubleshooting. CX Codex +1 168installs 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-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

Project sponsors

Companies that keep this analytics open