magento-claude-skills is a free, open-source Claude Code plugin that gives Claude (and the Claude Agent SDK) expert, current knowledge of Magento 2, Mage-OS, and Adobe Commerce development.
Claude Code
> /plugin marketplace add staksoft/magento-claude-skills> /plugin install magento-skills@magento-claude-skills
Codex
$ npx skills add staksoft/magento-claude-skills -a codex
Cursor
$ npx skills add staksoft/magento-claude-skills -a cursor
Gemini CLI
$ npx skills add staksoft/magento-claude-skills -a gemini-cli
GitHub Copilot
$ copilot plugin marketplace add staksoft/magento-claude-skills$ copilot plugin install magento-skills@magento-claude-skills
OpenCode
$ npx skills add staksoft/magento-claude-skills -a opencode
Windsurf
$ npx skills add staksoft/magento-claude-skills -a windsurf
magento-claude-skills is a free, open-source Claude Code plugin that gives Claude (and the Claude Agent SDK) expert, current knowledge of Magento 2, Mage-OS, and Adobe Commerce development. It makes the AI scaffold modules correctly, choose the right extension mechanism, and audit storefront performance — producing code that compiles with bin/magento setup:di:compile and passes phpcs --standard=Magento2 on the first try.
Maintained by StakSoft, a software studio with 10+ years of Magento and e-commerce engineering experience. Verified against Mage-OS 3.0.0 / Magento 2.4.9 on PHP 8.3.
Three skills that load on demand when you ask Claude a relevant question:
| Skill | What it does | Triggers on |
|---|---|---|
magento-module | Scaffold and extend Magento modules the right way — plugin vs observer vs preference decisions, declarative schema, dependency injection, admin UI, layout XML, REST/GraphQL APIs, CLI/cron/queues, PHPUnit testing, and debugging playbooks. | "create a Magento module", "observer or plugin?", "my layout XML isn't working", "setup:di:compile fails" |
magento-hyva | Hyvä theme development — Alpine.js + Tailwind CSS components, Magewire reactive components, child-theme setup and the Tailwind build, overriding templates/layout, and Luma→Hyvä compatibility. | "build a Hyvä theme", "Alpine.js in Magento", "Tailwind in Magento", "Magewire", "convert Luma to Hyvä" |
magento-audit | Performance audit of a Magento storefront — full-page cache leaks (cacheable="false" scanner), Varnish/Redis/env.php config, indexer and cron health, TTFB and Core Web Vitals. Works from a URL, a codebase, or both. | "my Magento store is slow", "audit storefront performance", "Varnish not caching", "FPC hit rate" |
In a benchmark of real module-build and debugging tasks, the magento-module skill scored 100% vs an 86% baseline (no skill) on a Mage-OS 2.4.9 install — every generated module compiled and passed the Magento coding standard.
Option 1 — npx skills (recommended, fastest): the vercel-labs/skills CLI installs all three skills into .claude/skills/. No clone needed.
npx skills add staksoft/magento-claude-skills -a claude-code
Add -g for a global install (all projects), or -y for non-interactive/CI.
Option 2 — Claude Code plugin marketplace: installs the whole plugin.
claude plugin marketplace add staksoft/magento-claude-skills
claude plugin install magento-skills
Option 3 — from a local clone:
git clone https://github.com/staksoft/magento-claude-skills.git
claude plugin install ./magento-claude-skills
The skills trigger automatically from natural language, or you can invoke them explicitly.
| Command | Use it to | Example |
|---|---|---|
/magento-module <Vendor_Module> | Scaffold a new module with correct registration.php, module.xml, and composer.json, then build the feature. | /magento-module Acme_GiftMessage |
/magento-module (free text) | Add a plugin/observer, declarative-schema table, admin grid, REST/GraphQL endpoint, CLI command, cron job, or PHPUnit tests. | "add a plugin that uppercases SKUs on save" |
/magento-hyva <Vendor/theme> | Scaffold a Hyvä child theme and build Alpine/Tailwind/Magewire components. | /magento-hyva Acme/storefront |
/magento-audit <url> | Audit a live storefront for full-page cache, TTFB, and Core Web Vitals issues. | /magento-audit https://store.example/ |
/magento-audit <path> | Audit a codebase for FPC killers, env.php cache config, and indexer/cron health. | /magento-audit ./app/code |
You don't have to type the command — asking "why isn't my product page caching?" or "create a module that adds a gift-message field to checkout" triggers the right skill on its own.
The magento-module and magento-audit skills know which bin/magento commands to run and how to read their output. This is the quick reference they apply — useful for any Magento 2 / Mage-OS developer:
| Command | Purpose |
|---|---|
bin/magento module:enable Vendor_Module | Enable a module after creating it. |
bin/magento setup:upgrade | Register modules, apply db_schema.xml and data patches. |
bin/magento setup:di:compile | Compile dependency injection; catches plugin and DI mistakes. |
bin/magento setup:db-declaration:generate-whitelist --module-name=Vendor_Module | Regenerate the declarative-schema whitelist after a db_schema.xml change. |
bin/magento cache:flush / cache:clean layout full_page block_html | Clear caches; targeted clean during layout development. |
bin/magento indexer:status / indexer:reindex / indexer:show-mode | Check, rebuild, and inspect indexers (any realtime indexer in production is a finding). |
bin/magento setup:static-content:deploy | Deploy static assets (required in production mode). |
bin/magento dev:di:info "Vendor\Class" | Show preferences, constructor args, and every plugin on a class — essential for debugging. |
bin/magento dev:template-hints:enable | Overlay block/template paths on the storefront to debug layout. |
bin/magento cron:install / cron:run --group=<group> | Install the system crontab; run a cron group on demand. |
bin/magento queue:consumers:list / queue:consumers:start <name> | Inspect and run message-queue consumers. |
bin/magento deploy:mode:show / deploy:mode:set developer | Show or switch between developer and production mode. |
vendor/bin/phpcs --standard=Magento2 app/code/Vendor/Module | Lint code against the official Magento 2 coding standard. |
magento-module — module developmentA SKILL.md workflow plus ten on-demand reference docs and a deterministic scaffold script:
di.xml argument decision treedb_schema.xml, the schema whitelist, EAV and extension attributessystem.xml config, ACL, menus, and ui_component admin gridswebapi.xml) and GraphQL (schema + resolvers) over service contracts, incl. getList()/SearchResultssetup:di:compile failures, layout not applying, stuck indexersmagento-hyva — Hyvä theme developmentA SKILL.md workflow plus six reference docs and a theme scaffold script:
theme.xml parent, the web/tailwind/ build@apply, and the purge/content trapwire:model/wire:click), validation, FPC safetymagento-audit — storefront performanceA cache-first audit workflow with five reference docs and two scripts:
cacheable="false" leaksenv.php, Redis, Varnish, OpenSearchcheck-headers.py (parses X-Magento-Cache-Debug, TTFB) and scan-layout.py (finds FPC killers)Generic LLM output for Magento is often subtly wrong, because the public web is full of decade-old tutorials. Common mistakes these skills prevent:
ObjectManager::getInstance() instead of constructor injectionInstallSchema/UpgradeSchema scripts instead of declarative db_schema.xml<preference> class rewrite where a plugin would compose without conflictcacheable="false" blocks that silently disable full-page cache for an entire pageEach skill encodes current Magento 2.4.x / Mage-OS conventions and a verification step, so Claude hands back code that compiles and passes phpcs --standard=Magento2 rather than plausible-looking code that breaks on setup:di:compile.
bin/magento setup:di:compile and phpcs --standard=Magento2 when a running install is available.These skills carry the procedures and conventions; for live store and merged-config access, pair them with a Magento MCP server:
Is this free? Yes. The plugin is open source under the MIT license. You only need Claude Code or the Claude Agent SDK.
Does it work with Adobe Commerce and Mage-OS, or only Magento Open Source? All three. Magento Open Source, Adobe Commerce, and Mage-OS share the same module architecture (2.4.x), so the conventions apply identically. It was verified on Mage-OS 3.0.0 (Magento 2.4.9).
What is a Claude skill? A skill is packaged expertise — instructions, reference docs, and scripts that load into Claude's context only when a relevant task appears. Unlike an MCP server, which gives Claude live access to a store, a skill changes how correctly Claude writes and debugs Magento code.
Do I need a Magento MCP server to use it?
Stars on GitHub
Helps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockA development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookmagento-claude-skills is a free, open-source Claude Code plugin that gives Claude (and the Claude Agent SDK) expert, current knowledge of Magento 2, Mage-OS, and Adobe Commerce development. Install it with the command on its page. It includes magento-audit, magento-hyva, magento-module. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it