Developing With Docker

Debugging-first guidance for professional Docker development across CLI, Compose, Docker Desktop, and Rancher Desktop.

Installation

Clone this repository to your Claude skills directory:

cd ~/.claude/skills
git clone https://github.com/SpillwaveSolutions/developing-with-docker-agentic-skill.git

Usage

This skill activates when you ask Claude to:

• Debug Docker
• Troubleshoot containers
• Fix Docker networking
• Resolve volume permissions
• Handle Docker Compose issues
• Explain cross-platform runtime behavior
• Explain Docker runtime architecture

Commands

• /docker-triage - Structured debugging triage
• /docker-compose-debug - Compose startup and dependency issues
• /docker-network-check - Networking and host reachability

Agents

• docker-troubleshoot-watcher - Proactively suggests debugging steps when Docker issues appear

Features

• Explain Docker architecture (CLI, dockerd, containerd, runc, shim) and why it matters
• Distinguish Linux-native behavior from macOS/Windows VM and WSL2 boundaries
• Provide reliable CLI/Compose command recipes for state inspection and debugging
• Diagnose performance issues tied to file sharing (VirtioFS, 9P) and build context size
• Apply pragmatic networking guidance for host-to-container and container-to-host access

Skill Structure

developing-with-docker-agentic-skill/
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── skills/
│   └── developing-with-docker/
│       ├── SKILL.md
│       └── references/
│           ├── guide-advanced-debugging.md
│           ├── guide-cli-debugging.md
│           ├── guide-foundations.md
│           ├── guide-installation-connectivity.md
│           ├── guide-networking-compose-ops.md
│           └── guide-rancher-migration.md
├── commands/
│   ├── docker-compose-debug.md
│   ├── docker-network-check.md
│   └── docker-triage.md
├── agents/
│   └── docker-troubleshoot-watcher.md
├── README.md
└── .gitignore

License

MIT License.

Author

Rick Hightower (rick@spillwave.com)