magento-local-environment-specialist — Claude Code skill
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.
MIT 164 installs ★ 33 updated 2026-01-24
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a claude-codeWhat magento-local-environment-specialist does
A single SKILL.md gives the agent a checklist for standing up Magento 2 on your machine. It starts with the stack question: Docker, Vagrant, or a MAMP/XAMPP install.
From there it goes through PHP values, a local database, cache for development, developer mode and Xdebug. Composer and Git get their own mentions as the tools you pull packages and versions with.
Adobe Commerce's install guide is linked at the bottom. When its steps and the skill's checklist part ways, follow the guide. Developer mode is what the skill recommends for local work; the setting shows up in both the setup and the practices sections.
What it helps with
- Stand up a local Magento 2 on Docker from scratch
- Set PHP, database and cache for development work
- Get Xdebug step debugging running in a local copy
- Repair a local install that broke after changing machines
- Write the setup steps down so the team repeats them
Example prompts for the agent
- Set up a local Magento 2 environment on Docker and switch the project to developer mode
- Configure Xdebug so I can step through my local Magento build
- My local Magento 2 stopped booting after the PHP upgrade — check the database and cache config
How to install magento-local-environment-specialist
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a claude-code2Manually: put the files in place
~/.claude/skills/magento-local-environment-specialist/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/magento-local-environment-specialist/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a codex2Manually: put the files in place
.agents/skills/magento-local-environment-specialist/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a cursor2Manually: put the files in place
.cursor/skills/magento-local-environment-specialist/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install maxnorm/magento2-agent-skills skills/magento-local-environment-specialist2Manually: put the files in place
.github/skills/magento-local-environment-specialist/SKILL.md1Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a gemini-cli2Platform CLI
gemini skills install https://github.com/maxnorm/magento2-agent-skills --path skills/magento-local-environment-specialistManually: put the files in place
.devin/skills/magento-local-environment-specialist/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-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-local-environment-specialist
How do I install magento-local-environment-specialist in Claude Code?
Run npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a claude-code. The skill file lands at ~/.claude/skills/magento-local-environment-specialist/SKILL.md.
What does this skill do?
It gives the agent an ordered path through a local Magento 2 install: picking a stack, configuring PHP and the database, cache, developer mode, Xdebug. It also helps when a local run stops working.
Which tools does it cover?
Docker, Vagrant, MAMP/XAMPP, Composer and Git. On the configuration side: PHP settings, a local database, cache and Xdebug step debugging.
Source text
SKILL.md · MIT
--- name: magento-local-environment-specialist description: Sets up and manages local Magento 2 development environments. Use when setting up local development, configuring local environments, or troubleshooting local setup issues. Masters local development tools, Docker, and development environment optimization. --- # Magento 2 Local Environment Specialist Expert specialist in setting up and managing local Magento 2 development environments. ## When to Use - Setting up local development environments - Configuring local development tools - Troubleshooting local setup issues - Optimizing local development performance - Setting up Docker environments ## Local Development Setup ### Development Tools - **Docker**: Containerized local development - **Vagrant**: Virtualized development environments - **MAMP/XAMPP**: Local server stacks - **Composer**: Dependency management - **Git**: Version control ### Environment Configuration - **PHP Configuration**: Configure PHP settings for development - **Database Setup**: Set up local databases - **Cache Configuration**: Configure caching for development - **Debug Mode**: Enable developer mode and debugging - **Xdebug**: Set up step-through debugging ## Best Practices - **Developer Mode**: Use developer mode for local development - **Debug Tools**: Set up debugging tools (Xdebug, etc.) - **Version Control**: Use Git for version control - **Dependency Management**: Use Composer for dependencies - **Documentation**: Document local setup processes ## References - [Adobe Commerce Installation](https://developer.adobe.com/commerce/php/development/install/) - [Local Development](https://developer.adobe.com/commerce/php/development/install/local/) Focus on creating efficient, easy-to-use local development environments.
© maxnorm · MIT · maxnorm/magento2-agent-skills