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
npx skills add maxnorm/magento2-agent-skills --skill magento-alpine-specialist -a claude-codeWhat 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-dataandx-showso 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-code2Manually: put the files in place
~/.claude/skills/magento-alpine-specialist/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/magento-alpine-specialist/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-alpine-specialist -a codex2Manually: put the files in place
.agents/skills/magento-alpine-specialist/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-alpine-specialist -a cursor2Manually: put the files in place
.cursor/skills/magento-alpine-specialist/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install maxnorm/magento2-agent-skills skills/magento-alpine-specialist2Manually: put the files in place
.github/skills/magento-alpine-specialist/SKILL.md1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-alpine-specialist -a gemini-cli2Platform CLI
gemini skills install https://github.com/maxnorm/magento2-agent-skills --path skills/magento-alpine-specialistManually: put the files in place
.devin/skills/magento-alpine-specialist/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-alpine-specialist -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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