This is a solid Docker troubleshooting companion that walks Claude through systematic debugging, from checking container exit codes to diagnosing networking issues. It covers the usual pain points like containers that exit immediately, build failures, and volume permission problems, with actual commands and fixes rather than vague advice. The best practices section hits the important stuff like multi-stage builds, proper layer caching, and running as non-root. Use this when you're stuck on Docker problems and want Claude to methodically work through diagnostics instead of guessing. It's comprehensive enough to handle most common Docker headaches without being overwhelming.

skills.sh installs
309
GitHub stars
422
last updated
Aug 21, 2026

Install

$ npx -y skills add onewave-ai/claude-skills --skill docker-debugger --agent claude-code

Installs into .claude/skills of the current project.

Files

Docker Debugger

Instructions

When debugging Docker issues:

  1. Identify the problem type: Build, runtime, networking, or performance
  2. Gather information using diagnostic commands
  3. Analyze logs and errors
  4. Apply fixes

Diagnostic Commands

# Check running containers
docker ps -a

# View container logs
docker logs <container_id> --tail 100 -f

# Inspect container
docker inspect <container_id>

# Check resource usage
docker stats

# View container processes
docker top <container_id>

# Execute shell in running container
docker exec -it <container_id> /bin/sh

# Check Docker disk usage
docker system df

# View build history
docker history <image_name>

Common Issues & Solutions

1. Container exits immediately

# Check exit code
docker inspect <container_id> --format='{{.State.ExitCode}}'

# View last logs
docker logs <container_id>

Fixes:

  • Ensure CMD/ENTRYPOINT runs a foreground process
  • Check for missing dependencies
  • Verify environment variables

2. Build fails

Sponsors

Details

Repository
github.com/onewave-ai/claude-skills
Categories
DevOps & CI/CD, Debugging, Mobile Development
First seen
Jun 3, 2026

More from onewave-ai/claude-skills

All 108
1nodeops-app avatarcreateos-deploynodeops-app/skillsDeploy projects to CreateOS infrastructure via the MPP Gateway. Use when the user wants to deploy code, ship an app, or deploy to CreateOS. No auth session or O297skills.sh installs
2patricio0312rev avatarpii-redaction-logging-policy-builderpatricio0312rev/skillsPrevents logging sensitive user data with redaction rules, logging policies, and safe log formatting. Use for "PII redaction", "log privacy", "GDPR logging", or276skills.sh installs
3patricio0312rev avatarmonorepo-ci-optimizerpatricio0312rev/skillsOptimizes CI pipelines for monorepos by detecting affected packages/apps and running only necessary builds and tests. Includes Turborepo/Nx strategies, caching,261skills.sh installs
4lenkin233 avatarxianyu-monitorlenkin233/xianyu-monitor-skillxianyu monitor252skills.sh installs
5sickn33 avatarterraform-skillsickn33/antigravity-awesome-skillsterraform skill245skills.sh installs
6sickn33 avatark8s-manifest-generatorsickn33/antigravity-awesome-skillsk8s manifest generator241skills.sh installs