developing-with-docker-plugin

# 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:

```bash
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 ([email protected])