Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add maxnorm/magento2-agent-skills --skill magento-local-environment-specialist -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/magento-local-environment-specialist/SKILL.md

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

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

Similar skills

All skills for DevOps and infrastructure →

From the same set30

The whole set →
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-alpine-specialist 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. CX Codex +1 166installs 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-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 magento-magewire-specialist The magento-magewire-specialist skill guides agents through building reactive Magewire components for Magento 2. Use it for server-driven interfaces with minimal JavaScript. CX Codex +1 153installs magento-luma-specialist magento-luma-specialist guides agents through customizing and extending Magento's default Luma theme. Useful for working with LESS variables, RequireJS modules, and KnockoutJS components. CX Codex +1 152installs

Project sponsors

Companies that keep this analytics open