| name | docker-debugging |
| description | Docker container debugging and management. Use when investigating container issues, checking logs, resource usage, or Docker Compose services. |
| allowed-tools | Bash(python *) |
Docker Debugging
Authentication
Docker commands run directly via the Docker CLI. No API keys are needed - the Docker socket must be accessible in the sandbox environment.
Available Scripts
All scripts are in .claude/skills/infrastructure-docker/scripts/
container_ps.py - List Containers
python .claude/skills/infrastructure-docker/scripts/container_ps.py [--all]
container_logs.py - Get Container Logs
python .claude/skills/infrastructure-docker/scripts/container_logs.py --container NAME_OR_ID [--tail 100]
container_inspect.py - Inspect Container
python .claude/skills/infrastructure-docker/scripts/container_inspect.py --container NAME_OR_ID
container_stats.py - Resource Usage Statistics
python .claude/skills/infrastructure-docker/scripts/container_stats.py [--container NAME_OR_ID]
image_list.py - List Docker Images
python .claude/skills/infrastructure-docker/scripts/image_list.py [--filter "reference=myapp*"]
compose_ps.py - List Compose Services
python .claude/skills/infrastructure-docker/scripts/compose_ps.py [--file docker-compose.yml] [--cwd /path]
compose_logs.py - Get Compose Service Logs
python .claude/skills/infrastructure-docker/scripts/compose_logs.py [--services "api,db"] [--tail 100]
Investigation Workflow
Container Debugging
1. List containers: container_ps.py --all
2. Check logs: container_logs.py --container <name> --tail 200
3. Check resources: container_stats.py --container <name>
4. Inspect config: container_inspect.py --container <name>
Docker Compose Debugging
1. Check services: compose_ps.py
2. Check logs: compose_logs.py --services "api,worker" --tail 100
Anti-Patterns to Avoid
- Never run destructive commands without explicit user approval (docker rm, docker rmi, docker system prune)
- Always use --tail for logs to avoid overwhelming output
- Check container status first before trying to exec into it
