docker-troubleshoot

Diagnose Docker daemon, environment, and docker-compose failures with remediation steps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/DaichiHoshina/ai-tools --skill docker-troubleshoot-daichihoshina
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-troubleshoot
Source: https://github.com/DaichiHoshina/ai-tools/tree/main/claude-code/skills/docker-troubleshoot
Command: npx skills add https://github.com/DaichiHoshina/ai-tools --skill docker-troubleshoot-daichihoshina

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This diagnostic guide helps you quickly identify and resolve common Docker connectivity and runtime issues, guiding you through environment checks and targeted fixes to get containers running again.

Core Features & Use Cases

  • Structured diagnostic flow: Detects daemon connectivity, environment setups (Lima, Docker Desktop, Rancher Desktop), and common failure modes.
  • Actionable remediation: Provides concrete commands and steps to resolve issues like cannot connect to Docker daemon, address already in use, Lima VM problems, and docker-compose failures.
  • Use Case: When a developer cannot start docker or the daemon becomes unavailable, follow the flow to restore normal operation and verify container status.

Quick Start

Diagnose your Docker setup by following the step-by-step flow to identify and fix the issue in your environment.

Frequently Asked Questions about docker-troubleshoot

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

FAQPage Schema
How do I fix the cannot connect to the Docker daemon error?

To resolve cannot connect to the Docker daemon errors, perform structured environment checks across Docker Desktop, Rancher Desktop, or Lima to detect daemon connectivity failures. This provides actionable remediation steps and verification commands to restore your container runtime.

Why does my Lima VM fail to start or connect to Docker?

Lima VM failures preventing Docker connectivity are diagnosed by checking your environment setup and common failure modes. The diagnostic flow guides you through targeted fixes for Lima VM problems to get containers running again.

How do I troubleshoot docker-compose failures during development?

To troubleshoot docker-compose failures, follow a structured diagnostic flow that checks the Docker daemon, environment configurations, and common runtime failure scenarios. It applies concrete commands and verification steps to resolve issues and reduce downtime.

Does this Docker diagnostic flow work with Rancher Desktop and Docker Desktop?

Yes, the Docker diagnostic flow works with Rancher Desktop and Docker Desktop by guiding structured checks of these environments. It detects common failure scenarios and provides targeted fixes to rapidly restore container runtimes across different setups.

What is the best way to diagnose address already in use errors in Docker?

The best way to diagnose address already in use errors in Docker is to follow a guided diagnostic flow that checks the daemon and environment for common failure scenarios. It provides concrete remediation commands to resolve port conflicts and verify container status.