# docker-local

docker-local guides coding agents through custom Docker Compose environments without DDEV. Helps run containers, execute stack commands, and debug local setups.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 109 installs · ★ 53 repo stars
- Author: madsnorgaard
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/madsnorgaard/drupal-agent-resources/tree/HEAD/.claude/skills/docker-local/SKILL.md
- Updated: 2026-09-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/docker-local

## What it does

This skill gives coding assistants standard workflows for hand-crafted `docker-compose.yml` setups. The agent first inspects the repository for Compose manifests, `.env` configs, and Makefiles. It then selects commands to launch services in detached mode, rebuild images, or inspect logs.

The instructions include reference configurations for a web stack using Nginx, PHP-FPM, MariaDB, and Redis. Specific Drupal routines cover invoking Drush and Composer via `docker compose exec`, alongside SQL export and import tasks. For slower filesystems on macOS or Windows, it outlines using `:cached` mounts and named volumes for dependencies.

Careless cleanup will wipe project data. Running `docker compose down -v` permanently drops your persistent volumes. The guide also details troubleshooting port collisions with `lsof` and fixing web root ownership.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill docker-local -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/docker-local/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/docker-local/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill docker-local -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/docker-local/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill docker-local -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/docker-local/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install madsnorgaard/drupal-agent-resources .claude/skills/docker-local
```

2. **Manually: put the files in place**
- File: `.github/skills/docker-local/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill docker-local -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/madsnorgaard/drupal-agent-resources --path .claude/skills/docker-local
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/docker-local/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill docker-local -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/madsnorgaard/drupal-agent-resources/tree/HEAD/.claude/skills/docker-local/SKILL.md

## When to use it
- inspect custom Docker Compose configurations and running services
- run Composer and Drush commands inside active containers
- import and dump SQL databases through Docker CLI
- fix file permissions and resolve port conflicts

## Example prompts
- Check the Docker environment files and list all running containers
- Export the MariaDB database into dump.sql using docker compose
- Generate a Makefile with shortcuts for Drush, Composer, and container logs

## Similar
- [docker-compose-production](https://affpapa.org/en/nevibecode/skills/docker-compose-production.md) — skill · 487 installs
- [docker-local-dev](https://affpapa.org/en/nevibecode/skills/docker-local-dev.md) — skill · 210 installs
- [docker](https://affpapa.org/en/nevibecode/skills/docker.md) — skill · 4000 installs
- [docker-compose-orchestration](https://affpapa.org/en/nevibecode/skills/docker-compose-orchestration.md) — skill · 3000 installs
- [docker-compose-patterns](https://affpapa.org/en/nevibecode/skills/docker-compose-patterns.md) — skill · 2900 installs
- [docker-project-foundations](https://affpapa.org/en/nevibecode/skills/docker-project-foundations.md) — skill · 1700 installs

From the same set: [madsnorgaard/drupal-agent-resources](https://affpapa.org/en/nevibecode/by/madsnorgaard/drupal-agent-resources.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
