container-debug

Inspect Docker container logs, exec shells, and validate health checks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nakamotosai/chii --skill container-debug-nakamotosai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: container-debug
Source: https://github.com/nakamotosai/chii/tree/main/skills/container-debug
Command: npx skills add https://github.com/nakamotosai/chii --skill container-debug-nakamotosai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging and diagnosing Docker containers and Compose services quickly, by giving you direct access to logs, container state, networks, health checks, and service dependencies.

Core Features & Use Cases

  • Inspect container logs and filter by service
  • Exec into containers with an interactive shell or run one-off commands
  • Diagnose networking, health checks, and resource usage across multi-service setups
  • Troubleshoot Compose service startup order and dependencies

Quick Start

Start by checking container logs, then attach to a running container with an interactive shell to inspect processes and networking.

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 crashes on startup?

To debug a Docker container that crashes on startup, inspect the container logs and validate health checks to identify the failure. You can then attach to the container with an interactive shell to inspect processes and determine the startup crash cause.

What is the best way to troubleshoot Docker Compose service communication failures?

Troubleshoot Docker Compose service communication failures by diagnosing networking configurations and validating service dependencies. Inspect logs filtered by service to pinpoint inter-container misbehavior and resolve service communication issues.

How do I fix misordered dependencies in Docker Compose?

Fix misordered dependencies in Docker Compose by validating health checks and inspecting service startup order. Diagnosing networking and resource visibility across multi-service setups ensures deterministic debugging steps for local development and CI workflows.

Can I inspect Docker container logs filtered by specific services?

Yes, you can inspect Docker container logs filtered by specific services. This helps quickly diagnose running Docker containers and Compose services by isolating log output to identify startup crashes or in-container misbehavior.

Why does my Docker Compose health check keep failing in CI workflows?

Docker Compose health checks fail in CI workflows due to misordered dependencies or networking issues. Validate health checks and inspect container state to ensure deterministic debugging steps and resolve service startup failures.