Docker Compose Stack Doctor

Diagnose why your Docker Compose stack won't come up: port conflicts, bad or missing env vars, absent healthchecks, volume and permission issues, depends_on that doesn't wait for readiness, networking gaps, platform mismatches, and databases that aren't ready.

Install
cmdop skills install agensi-docker-compose-stack-doctor

The Ultimate Diagnostic Tool for Docker Compose

Stop wasting hours chasing "Exited (1)" errors and networking ghosts. The Docker Compose Stack Doctor is a specialized diagnostic skill designed for developers who need to fix broken local environments fast. It provides a structured, evidence-led workflow to identify why your containers won't start, why services can't talk to each other, or why your volumes aren't persisting data.

What it does

This skill goes beyond simple error log reading. It implements a rigorous "evidence-first" devops workflow using a bundled heuristic scanner and comprehensive audit checklists. It analyzes your YAML files, logs, and environment configurations to pinpoint issues across:

  • Networking & Ports: Identifies port conflicts and depends_on readiness failures.
  • Environment & Secrets: Finds missing variables and platform/architecture mismatches.
  • Storage: Diagnoses volume permission issues and mount paths.
  • Runtime: Evaluates healthcheck logic and database readiness.

Why use this skill?

Unlike a general LLM that might hallucinate fixes or suggest dangerous commands, this skill follows a safety-first protocol. It explicitly separates confirmed findings from hypotheses, cites exact evidence for every claim, and provides safe, copy-paste remediation snippets. It includes a local read-only scanner to ensure findings are grounded in your actual project state, not just general advice.

The Output

You receive a professional diagnostic report ranked by severity (Critical to Info). Each finding includes the evidence found, the impact on your stack, a safe remediation snippet, and concrete verification steps to ensure the fix actually worked.