# docker-compose-orchestration

A skill that helps your agent write Docker Compose files for multi-container apps: services, networks, volumes, health checks and startup order.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2900 installs · ★ 62
- Author: manutej
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-devops-suite/skills/docker-compose-orchestration/SKILL.md
- Updated: 2026-06-13
- HTML: https://affpapa.org/en/nevibecode/skills/docker-compose-orchestration

## What it does

The skill hands the agent ready patterns for compose files. It walks through the `services`, `networks`, `volumes`, `configs` and `secrets` sections, shows a service built from an existing image and one built from a `Dockerfile`, and covers dependencies declared with `depends_on` plus the `service_healthy` and `service_started` conditions.

Multi-container setups get their own section. A frontend, backend and database example shows ports, environment variables, volumes and networks per service, with the backend waiting on the database health check. Advanced options are there too: `command`, `working_dir`, `user`, `env_file`, resource limits and logging settings.

The examples target Compose file version 3.8 and images such as `postgres:15-alpine` or `redis:alpine`. Running a different compose schema, or moving the same stack to Kubernetes, means rewriting the samples yourself.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill docker-compose-orchestration -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill docker-compose-orchestration -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill docker-compose-orchestration -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install manutej/luxor-claude-marketplace docker-compose-orchestration
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill docker-compose-orchestration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-devops-suite/skills/docker-compose-orchestration
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill docker-compose-orchestration -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/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-devops-suite/skills/docker-compose-orchestration/SKILL.md

## When to use it
- write a compose file for a frontend, an API and a database
- set startup order with a health check
- move environment variables into `env_file`
- attach persistent storage through named volumes
- split services across separate networks

## Example prompts
- Write a compose file with separate services for the frontend, backend and PostgreSQL
- Add a health check to the database service and start the API only once it passes
- Create a named volume for PostgreSQL data and mount it in the database service

## Similar
- [wizard](https://affpapa.org/en/nevibecode/skills/wizard.md) — skill · 553369 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [using-git-worktrees](https://affpapa.org/en/nevibecode/skills/using-git-worktrees.md) — skill · 217153 installs
- [finishing-a-development-branch](https://affpapa.org/en/nevibecode/skills/finishing-a-development-branch.md) — skill · 214439 installs
- [orca-cli](https://affpapa.org/en/nevibecode/skills/orca-cli.md) — skill · 353600 installs

From the same set: [manutej/luxor-claude-marketplace](https://affpapa.org/en/nevibecode/by/manutej/luxor-claude-marketplace.md) — 38 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