# docker-compose

Orchestrates multi-container applications and networks via Docker Compose V2. Helpful for local service development, testing, and debugging.

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

## What it does

This skill guides the agent through managing containers and networks using the modern `docker compose` CLI plugin. It relies on `Bash` and `Read` tools to inspect project manifests, verify service states, and execute commands. The workflow targets canonical `compose.yaml` files rather than legacy Compose V1 binaries.

Token consumption drops by roughly 92%. Detailed instructions load on demand instead of cluttering the prompt context. The agent checks container states with `docker compose ps`, verifies configuration validity through `docker compose config`, and monitors live changes via Compose Watch.

A running Docker daemon and proper permissions for the Docker socket are mandatory prerequisites. Without the Compose V2 plugin installed on the host, the skill cannot operate.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill docker-compose -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill docker-compose -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill docker-compose -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oimiragieo/agent-studio .claude/skills/docker-compose
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill docker-compose -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/oimiragieo/agent-studio --path .claude/skills/docker-compose
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill docker-compose -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/oimiragieo/agent-studio/tree/HEAD/.claude/skills/docker-compose/SKILL.md

## When to use it
- Spin up service stacks in detached mode
- Validate `compose.yaml` syntax before launch
- Inspect logs for failing application containers
- Configure live file reload using Compose Watch

## Example prompts
- Start all services defined in compose.yaml in the background
- Inspect the logs for the api service and check its health status
- Run docker compose config to validate the current configuration file

## Similar
- [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-compose-creator](https://affpapa.org/en/nevibecode/skills/docker-compose-creator.md) — skill · 108 installs
- [docker-project-foundations](https://affpapa.org/en/nevibecode/skills/docker-project-foundations.md) — skill · 1700 installs
- [docker](https://affpapa.org/en/nevibecode/skills/bobmatnyc-docker.md) — skill · 1100 installs
- [docker-containerization](https://affpapa.org/en/nevibecode/skills/aj-geddes-docker-containerization.md) — skill · 683 installs

## Other versions with the same name
- [docker-compose · bagelhole](https://affpapa.org/en/nevibecode/skills/docker-compose.md) — 614 installs

From the same set: [oimiragieo/agent-studio](https://affpapa.org/en/nevibecode/by/oimiragieo/agent-studio.md) — 8 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
