DO
docker-compose-stack-doctor
Diagnose and stabilize Docker Compose stacks across local and server environments. Use when services fail to start, containers cannot connect, env variables are missing, volumes break, or network naming conflicts appear across multiple projects.
Install
mkdir -p .claude/skills/docker-compose-stack-doctor && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14835" && unzip -o skill.zip -d .claude/skills/docker-compose-stack-doctor && rm skill.zipInstalls to .claude/skills/docker-compose-stack-doctor
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Diagnose and stabilize Docker Compose stacks across local and server environments. Use when services fail to start, containers cannot connect, env variables are missing, volumes break, or network naming conflicts appear across multiple projects.245 chars✓ has a “when” trigger
About this skill
Docker Compose Stack Doctor
Workflow
- Normalize Compose inputs.
Run
docker compose configand inspect merged output. - Check service readiness assumptions.
Verify healthchecks,
depends_onconditions, and startup order. - Validate network and port plan. Detect host port collisions and external network name mismatches.
- Validate data and config mounts. Check bind mount paths, permission issues, and missing host files.
- Confirm recovery path. Define commands for clean restart, selective rebuild, and log triage.
Output Contract
Always provide:
- Broken service and exact failure signal.
- Minimal compose or env fixes.
- Safe restart sequence.
- Preventive checks for future changes.