debug

Diagnose Docker and Docker Compose issues via container diagnostics, log collection, and network testing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive toolkit to systematically find and resolve bugs within Docker and Docker Compose environments, eliminating the need for local application setup.

Core Features & Use Cases

  • Container Diagnostics: Deep dives into individual container health, resources, network, and processes.
  • Log Aggregation: Collects logs from all services for centralized analysis.
  • Network Testing: Verifies connectivity between services and external hosts.
  • Use Case: When your multi-service application running in Docker Compose experiences intermittent connection failures between the API and database, this Skill can help pinpoint the root cause by checking network configurations, service logs, and connectivity tests.

Quick Start

Run comprehensive diagnostics on the 'api-service' container.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug connection failures between Docker Compose services?

To debug connection failures between Docker Compose services, you can run network testing and container diagnostics to verify connectivity, check network configurations, and collect service logs to pinpoint the root cause.

What is the best way to collect logs from all Docker Compose services for analysis?

The best way to collect logs from all Docker Compose services is through log aggregation, which gathers container outputs into a centralized stream for detailed analysis and troubleshooting of application errors.

How do I diagnose health and performance bottlenecks in a Docker container?

To diagnose health and performance bottlenecks in a Docker container, use container diagnostics tools to deep dive into resource usage, running processes, network settings, and overall container health.

Does this approach require setting up my application locally to troubleshoot Docker issues?

No, this troubleshooting approach does not require local application setup, as it directly utilizes Python and shell scripts to analyze Docker environments, run diagnostics, and resolve container issues remotely.

Why does my Docker Compose application experience intermittent connectivity problems?

Intermittent connectivity problems in Docker Compose often stem from misconfigured networks or service failures, which you can identify by performing network testing and checking container health and logs.

What are the limitations of using shell scripts for Docker container troubleshooting?

Using shell scripts for Docker container troubleshooting provides detailed analysis and problem resolution, but requires an understanding of Docker networking and container environments to interpret diagnostics and connectivity test results accurately.