# docker

Guides your agent to write container setups with multi-stage builds, non-root users, pinned image tags, and strict .dockerignore hygiene.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 122 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/docker/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ulpi-io-docker

## What it does

This skill acts as an execution shell over a curated set of Docker reference docs. It forces the agent to read `references/stack.md` before touching any code, pulling in base image choices, registry targets, and builder tooling. Only the guide files needed for the immediate step get loaded into context.

Several invariants govern every Dockerfile and Compose file created. The agent requires multi-stage setups by default, isolates runtime execution under a non-root `USER`, and rejects `:latest` tags in production targets. Secrets cannot pass through `ARG`, `ENV`, or direct `COPY` statements; BuildKit secret mounts must take their place.

Manifests for Kubernetes are outside its scope, as the skill handles image build infrastructure rather than cluster orchestrators.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill docker -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/docker/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/docker/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill docker -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/docker/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill docker -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/docker/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills docker
```

2. **Manually: put the files in place**
- File: `.github/skills/docker/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill docker -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path docker
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/docker/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill docker -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ulpi-io/skills/tree/HEAD/docker/SKILL.md

## When to use it
- generate production Dockerfiles using non-root runtime users
- shrink image context and strip build artifacts with .dockerignore
- configure docker-compose services with working health probes
- isolate build dependencies across multi-stage image steps

## Example prompts
- Write a multi-stage Dockerfile for Go that runs as an unprivileged user
- Add a health check and volume mounts to our docker-compose service
- Debug why this container fails to resolve networking during build

## Similar
- [docker-expert](https://affpapa.org/en/nevibecode/skills/sickn33-docker-expert.md) — skill · 27500 installs
- [docker-best-practices](https://affpapa.org/en/nevibecode/skills/docker-best-practices.md) — skill · 951 installs
- [docker-management](https://affpapa.org/en/nevibecode/skills/docker-management.md) — skill · 577 installs
- [docker-containerization](https://affpapa.org/en/nevibecode/skills/curiositech-docker-containerization.md) — skill · 143 installs
- [containerization-docker-best-practices](https://affpapa.org/en/nevibecode/rules/containerization-docker-best-practices.md) — rule · ★ 41430 repo stars
- [docker-development](https://affpapa.org/en/nevibecode/plugins/docker-development.md) — plugin · ★ 30251 repo stars

## Other versions with the same name
- [docker · codewithmukesh](https://affpapa.org/en/nevibecode/skills/docker.md) — 4000 installs
- [docker · mindrally](https://affpapa.org/en/nevibecode/skills/mindrally-docker.md) — 1200 installs
- [docker · bobmatnyc](https://affpapa.org/en/nevibecode/skills/bobmatnyc-docker.md) — 1100 installs
- [docker · openhands](https://affpapa.org/en/nevibecode/skills/openhands-docker.md) — 126 installs
- [docker · oakoss](https://affpapa.org/en/nevibecode/skills/oakoss-docker.md) — 145 installs

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
