ddev-expert — Claude Code skill for DDEV projects
A skill that feeds your agent DDEV commands: starting containers, database work, config and common troubleshooting.
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a claude-codeWhat ddev-expert does
DDEV is a Docker-based local environment for PHP projects. This skill hands the agent the commands and settings it needs, so it stops guessing how to boot a project or pull a database. Handy if you run a Drupal site and want the assistant to suggest ddev start, ddev import-db or ddev drush cr instead of generic advice.
It covers .ddev/config.yaml, extra services like Redis and Solr, Xdebug setup for VS Code and PHPStorm, plus workflows for new and existing projects. Troubleshooting gets its own section: port conflicts, file permissions, database connection errors. On Drush the skill is blunt — it is not part of Drupal 11's recommended-project, so you install it with ddev composer require drush/drush.
One gotcha is worth knowing before you start. ddev composer create-project wants an empty directory, so .claude/ and .git/ have to be moved out and put back afterwards. If you already have a settled DDEV routine, the skill may just echo it back — check whether it actually adds anything to your setup.
What it helps with
- boot a local Docker environment for a Drupal project
- move a database in and out with
ddev import-dbandddev export-db - wire up Redis or Solr as an extra service
- turn on Xdebug and connect it to VS Code or PHPStorm
- sort out a port conflict or file permission error
Example prompts for the agent
- Start the project with ddev and show me which containers came up
- Import the dump from
database.sql.gzand clear the Drush cache - Add Redis in
.ddev/docker-compose.redis.yamland set it up in settings.php
How to install ddev-expert
1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a claude-code2Manually: put the files in place
~/.claude/skills/ddev-expert/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ddev-expert/
1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a codex2Manually: put the files in place
.agents/skills/ddev-expert/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a cursor2Manually: put the files in place
.cursor/skills/ddev-expert/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install madsnorgaard/drupal-agent-resources ddev-expert2Manually: put the files in place
.github/skills/ddev-expert/SKILL.md1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a gemini-cli2Platform CLI
gemini skills install https://github.com/madsnorgaard/drupal-agent-resources --path .claude/skills/ddev-expertManually: put the files in place
.devin/skills/ddev-expert/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -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 ddev-expert
How do I install ddev-expert in Claude?
Run npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a claude-code. The skill file lands at ~/.claude/skills/ddev-expert/SKILL.md.
What does ddev-expert do?
It gives the agent DDEV knowledge: project commands, configuration, database handling, extra services and fixes for common failures.
Which platforms does it support?
It runs in Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode, each with its own install command.