Magento & Mage-OS Claude Skills: Free AI Plugin for Correct, Compiling Code

StakSoft has open-sourced magento-claude-skills — a free Claude Code plugin that gives Claude expert, up-to-date knowledge of Magento 2, Mage-OS, and Adobe Commerce development. It makes the AI scaffold modules, build Hyvä themes, write PHPUnit tests, and audit storefront performance — producing code that compiles with bin/magento setup:di:compile and passes phpcs --standard=Magento2 on the first try. Install it in one line:

npx skills add staksoft/magento-claude-skills -a claude-code

Why generic AI gets Magento wrong

Magento 2 is convention-heavy, and the public web is full of decade-old tutorials. Ask a generic AI assistant to “create a Magento module” and you routinely get:

• ObjectManager::getInstance() instead of constructor injection

• Deprecated InstallSchema scripts instead of declarative db_schema.xml

• A class <preference> (global rewrite) where a plugin would compose without conflict

• Block classes instead of view models for template logic

• A cacheable="false" block that silently disables full-page cache for an entire page

It looks plausible — and breaks on compile. These skills encode current Magento 2.4.x / Mage-OS conventions plus a verification step, so the output is correct, not just convincing.

What's in the plugin: three skills

The skills load automatically when you ask a relevant question — no manual command needed.

How to install

# Option 1 — vercel-labs/skills CLI (recommended)
npx skills add staksoft/magento-claude-skills -a claude-code

# Option 2 — Claude Code plugin marketplace
claude plugin marketplace add staksoft/magento-claude-skills
claude plugin install magento-skills

Commands and how to use them

You can also just ask in plain English — “create a module that adds a gift-message field to checkout” or “why isn't my product page caching?” — and the right skill activates.

Example use cases

• “Create a module Acme_GiftMessage that adds a gift-message field to checkout” → scaffolds the module, a declarative-schema table, and a plugin/observer, then compiles it.

• “setup:di:compile is failing with an incompatible-argument error” → walks the debugging playbook to find and fix the cause.

• “Add a REST endpoint and a GraphQL query to my module” → builds service contracts with correct getList()/SearchResults wiring.

• “Build a Hyvä FAQ accordion with Alpine.js” or “convert my Luma module to Hyvä” → produces Alpine/Tailwind/Magewire components.

• “Audit my storefront's performance” → returns a severity-ranked report with exact fixes.

Does it actually work? We measured it.

In a benchmark of real build-and-debug tasks on a Mage-OS 3.0.0 / Magento 2.4.9 install, the magento-module skill scored 100% vs an 86% baseline with no skill — every generated module compiled and passed the Magento coding standard. We also installed the published package via npx skills and had it build a module with a custom table, repository, and CLI command end to end; it compiled clean.

Frequently asked questions

Open source on GitHub · MIT License · npx skills add staksoft/magento-claude-skills -a claude-code