container-debug

Diagnose Docker container and Compose service failures via logs, networking, and health checks.

2|1|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/albertdobmeyer/opentrapp --skill container-debug-albertdobmeyer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: container-debug
Source: https://github.com/albertdobmeyer/opentrapp/tree/main/workloads/skills/skills/container-debug
Command: npx skills add https://github.com/albertdobmeyer/opentrapp --skill container-debug-albertdobmeyer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and fix Docker container and Compose service failures when applications crash, misbehave in containers, fail to connect, or never become healthy.

Core Features & Use Cases

  • Log Analysis: Inspect and filter container or Compose logs to find crash causes and runtime errors.
  • Interactive Debugging: Exec into running containers, check environment state, and validate file system contents.
  • Networking Troubleshooting: Verify service discovery, port bindings, DNS resolution, and cross-container connectivity.
  • Resource and Build Diagnosis: Investigate CPU or memory pressure, OOM kills, multi-stage build issues, and health check failures.
  • Use Case: When an API container cannot reach its database, use this Skill to compare networks, confirm bind addresses, review logs, and isolate the dependency break.

Quick Start

Ask for a Docker debugging walkthrough for the failing container or Compose service, and include the observed symptoms so the investigation can begin immediately.

Frequently Asked Questions about container-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Docker container that keeps crashing?

To debug a crashing Docker container, you need to inspect its logs and exec into the environment to check runtime state. This Skill diagnoses container failures by analyzing logs, validating file systems, and identifying crash causes or OOM kill events.

Why does my Docker Compose service fail to connect to another container?

Docker Compose connectivity failures often stem from network misconfigurations or DNS resolution issues. This Skill troubleshoots networking by verifying service discovery, checking port bindings, and confirming cross-container connectivity to isolate dependency breaks.

How do I find the cause of an OOM kill in a Docker container?

To find the cause of a Docker OOM kill, you must investigate resource usage and memory pressure within the container. This Skill diagnoses resource exhaustion by analyzing container health checks and correlating crash logs with OOM termination events.

Can I troubleshoot multi-stage build issues and startup-order bugs in Compose?

Yes, you can troubleshoot multi-stage build issues and Compose startup-order bugs by inspecting build logs and health check statuses. This Skill diagnoses build failures and validates startup sequences to ensure deployed Compose services initialize dependencies correctly.

Do I need Docker CLI access to debug containers with this approach?

Yes, you need Docker CLI access to inspect running or stopped containers and execute debugging commands. This Skill requires local or deployed Docker CLI access to perform log analysis, exec access, and network troubleshooting workflows.

What is the best way to diagnose a Docker container that never becomes healthy?

The best way to diagnose a Docker container that never becomes healthy is to review its health check configuration and application logs. This Skill investigates health check failures by validating startup logic, checking resource limits, and analyzing runtime errors.