Skip to main content
skill CX Codex

ddev-expert — Claude Code skill for DDEV projects

A skill that feeds your agent DDEV commands: starting containers, database work, config and common troubleshooting.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add madsnorgaard/drupal-agent-resources --skill ddev-expert -a claude-code
Open on GitHub

What 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-db and ddev 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.gz and clear the Drush cache
  • Add Redis in .ddev/docker-compose.redis.yaml and 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-code

2Manually: put the files in place

~/.claude/skills/ddev-expert/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ddev-expert/

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.

Similar skills

Everything for DevOps and infrastructure →

From the same set3

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor