К основному содержанию
скилл CX Codex

docker · oakoss — скилл для Claude Code: контейнеризация и деплой

Скилл для сборки Docker-образов, настройки Compose-стеков и подготовки контейнеров к продакшену.

MIT 145 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill docker -a claude-code
Открыть на GitHub

Что делает docker

Скилл покрывает многоэтапную сборку, кеширование слоёв, docker-compose.yaml, сети, volume, health-проверки и защиту контейнеров. Агент пишет Dockerfile с отдельными стадиями сборки и рантайма (сокращает размер образа на 80 % и больше), копирует package-lock.json до исходников (слой с зависимостями кешируется), создаёт непривилегированного пользователя для финальной стадии. Внутри — таблица паттернов с ключевыми решениями, список типичных ошибок (установка dev-зависимостей в продакшене, копирование исходников до npm ci, отсутствие .dockerignore) и отсылки к reference-файлам по безопасности, multi-platform-сборке и CI-кешированию.

Подходит для контейнеризации приложений, dev-окружений, мультисервисных стеков и деплоя на ECS, Kubernetes, Fly.io, Railway, Coolify. Без FFmpeg, Python или дополнительных библиотек скилл работает сразу. Для монорепозиториев упоминает turbo prune --docker (минимальный build context из зависимостей workspace), но Turborepo не требует — команда опциональна.

Какие задачи решает

  • написать Dockerfile с многоэтапной сборкой и кешированием слоёв
  • настроить compose.yaml с сервисами, сетями и volume
  • добавить непривилегированного пользователя и health-проверку
  • собрать multi-platform образ для ARM и x86
  • исключить секреты из слоёв образа через --mount=type=secret

Примеры запросов агенту

  • Напиши Dockerfile для Node.js-приложения с многоэтапной сборкой, alpine-образом и непривилегированным пользователем
  • Настрой compose.yaml для Postgres, Redis и бэкенда с named volume для базы
  • Добавь в Dockerfile health-проверку через curl /health и .dockerignore с node_modules и .git

Как установить docker

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill docker -a claude-code

2Вручную: положить файлы

~/.claude/skills/docker/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/docker/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о docker

Как установить docker в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill docker -a claude-code. Скилл установится в ~/.claude/skills/docker/SKILL.md.

Что делает скилл docker?

Скилл помогает писать Dockerfile с многоэтапной сборкой, настраивать Compose-стеки, оптимизировать размер образов, добавлять health-проверки и готовить контейнеры к продакшену.

Чем многоэтапная сборка отличается от обычной?

Многоэтапная сборка разделяет стадии builder и production: dev-зависимости и артефакты сборки остаются в первой стадии, в финальный образ копируются только нужные файлы. Размер образа сокращается на 80 % и больше.

Исходный текст

SKILL.md · MIT
---
name: docker
description: |
  Docker containerization for development and production. Covers Dockerfiles, multi-stage builds, layer caching, Compose services, networking, volumes, health checks, security hardening, and production deployment patterns.

  Use when writing Dockerfiles, optimizing image size, configuring Compose services, debugging container networking, setting up health checks, hardening containers for production, or troubleshooting build cache issues.
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://docs.docker.com'
user-invocable: false
---

# Docker

## Overview

Docker packages applications into isolated containers that run consistently across environments. A Dockerfile defines the image build steps, Compose orchestrates multi-container services, and production patterns ensure small, secure, performant images.

**When to use:** Containerizing applications, creating reproducible dev environments, orchestrating multi-service stacks, deploying to container platforms (ECS, Kubernetes, Fly.io, Railway, Coolify).

**When NOT to use:** Simple static sites with no backend (use CDN deploy), single-binary CLI tools (distribute the binary), or when the target platform has native buildpacks (Heroku, Vercel) and you don't need container control.

## Quick Reference

| Pattern              | Approach                                       | Key Points                                           |
| -------------------- | ---------------------------------------------- | ---------------------------------------------------- |
| Multi-stage build    | Separate `builder` and `production` stages     | 80%+ image size reduction, no dev deps in production |
| Layer caching        | Copy lockfile first, install, then copy source | Dependency layer cached across builds                |
| Non-root user        | `RUN adduser` + `USER` in final stage          | Never run production containers as root              |
| Health check         | `HEALTHCHECK CMD curl` or node/python check    | Enables orchestrator restart on failure              |
| `.dockerignore`      | Exclude `node_modules`, `.git`, `.env`         | Smaller build context, faster builds                 |
| Compose services     | `compose.yaml` with service definitions        | Dev environment in one command                       |
| Compose override     | `compose.prod.yaml` with production settings   | Environment-specific config without duplication      |
| Named volumes        | `volumes:` in Compose for persistent data      | Survives container recreation                        |
| Build cache mount    | `RUN --mount=type=cache,target=/root/.npm`     | Persistent cache across builds                       |
| Secrets in build     | `RUN --mount=type=secret,id=token`             | Never bake secrets into image layers                 |
| Image pinning        | Pin to major.minor or digest                   | Reproducible builds, avoid surprise breakage         |
| Container networking | Custom bridge networks with service discovery  | Containers resolve each other by service name        |
| Compose watch        | `develop.watch` with sync/rebuild actions      | Live reload without volume mounts                    |
| Init process         | `--init` flag or `tini` entrypoint             | Proper signal handling and zombie reaping            |
| Multi-platform       | `docker buildx build --platform`               | ARM (Apple Silicon, Graviton) + x86 in one image     |
| Monorepo prune       | `turbo prune app --docker`                     | Minimal build context from workspace dependencies    |
| CI layer caching     | `cache-from`/`cache-to` with GHA or registry   | Avoid full rebuilds in CI pipelines                  |
| Debug containers     | `docker exec`, `docker logs`, `dive`           | Inspect running containers and image layers          |

## Common Mistakes

| Mistake                                         | Correct Pattern                                                  |
| ----------------------------------------------- | ---------------------------------------------------------------- |
| Installing dev dependencies in production image | Multi-stage build: install in builder, copy artifacts to runtime |
| Copying source before installing dependencies   | Copy lockfile first, `npm ci`, then copy source for cache reuse  |
| Running as root in production                   | Create non-root user, `USER` directive in final stage            |
| Hardcoding secrets in Dockerfile or ENV         | Use build secrets (`--mount=type=secret`) or runtime env         |
| Using `latest` tag for base images              | Pin to specific version (`node:24-alpine`)                       |
| No `.dockerignore` file                         | Exclude `node_modules`, `.git`, `.env`, build artifacts          |
| Using `npm install` instead of `npm ci`         | `npm ci` for deterministic, lockfile-based installs              |
| HEALTHCHECK missing                             | Add health check for orchestrator integration                    |
| Large base images (`node:24`)                   | Use alpine variants (`node:24-alpine`) for smaller images        |
| Ignoring `.env` file precedence in Compose      | `environment:` in Compose overrides `.env` file values           |
| Building entire monorepo for one service        | Use `turbo prune --docker` for minimal build context             |
| No layer caching in CI                          | Use `cache-from`/`cache-to` with GHA or registry backend         |
| Building only for x86 when deploying to ARM     | Use `docker buildx` with `--platform linux/amd64,linux/arm64`    |

## Delegation

- **Dockerfile review**: Use `Task` agent to audit Dockerfiles for size, security, and caching
- **Compose exploration**: Use `Explore` agent to discover existing Docker configurations
- **Architecture decisions**: Use `Plan` agent for container orchestration strategy

> If the `ci-cd-architecture` skill is available, delegate CI/CD pipeline and deployment strategy to it.
> If the `application-security` skill is available, delegate container security scanning and hardening review to it.

## References

- [Dockerfile patterns: multi-stage builds, layer caching, and image optimization](references/dockerfile-patterns.md)
- [Compose: services, networking, volumes, and environment management](references/compose.md)
- [Security: non-root users, secrets, scanning, and production hardening](references/security.md)
- [Buildx: multi-platform builds for ARM and x86](references/buildx-and-multiplatform.md)
- [CI: GitHub Actions caching, registry push, and automated builds](references/ci-caching.md)
- [Monorepo: Turborepo prune, pnpm workspaces, and selective builds](references/monorepo-builds.md)
- [Debugging: logs, exec, inspect, layer analysis, and network troubleshooting](references/debugging.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — docker от других авторов.

docker codewithmukesh Скилл docker настраивает контейнеризацию приложений на .NET 10: многоэтапную сборку, запуск под непривилегированным пользователем и проверку работоспособности. CX Codex +1 4 000установок docker Mindrally Задаёт правила сборки легковесных контейнеров, многоэтапных Dockerfile и конфигураций Docker Compose. CX Codex +1 1 200установок docker bobmatnyc Скилл docker для Claude Code помогает упаковать приложение с зависимостями в Docker-контейнер. Он описывает Dockerfile, сборку образов и работу нескольких сервисов через Compose. CX Codex +1 1 100установок docker OpenHands Запускает Docker-демон и выполняет команды Docker внутри контейнера агента. Нужен, чтобы собирать образы, запускать контейнеры и управлять ими из Claude Code, Cursor или Codex. CX Codex +1 126установок docker ulpi-io Направляет агента по правилам сборки контейнеров: многоэтапные билды, non-root пользователи, pinned-теги и обязательный .dockerignore. CX Codex +1 122установок docker-expert sickn33 Скилл docker-expert для Claude Code разбирает Dockerfile, Compose-конфиги и рантайм контейнеров. Включается при сборке образа, проверке сборки или поиске причины сбоя контейнера. CX Codex +1 27 500установок docker-best-practices JosiahSiegel Скилл docker-best-practices по Docker: подсказывает, как писать Dockerfile, выбирать базовый образ и настраивать контейнеры для продакшена. CX Codex +1 951установок setup-docker-containers davila7 Команда setup-docker-containers настраивает Docker для разработки и production, включая multi-stage сборки, Compose и рабочие процессы контейнеров. CX Codex +1 740установок render-docker Render Скилл render-docker помогает агенту писать Dockerfile и настраивать деплой контейнеров на Render: сборка, приватные реестры, кэш слоёв. CX Codex +1 463установок docker-deployment pluginagentmarketplace Скилл docker-deployment помогает контейнеризировать Node.js-приложение: Dockerfile, multi-stage сборка, Docker Compose и подготовка образа к продакшену. CX Codex +1 531установок docker-compose-orchestration manutej Скилл docker-compose-orchestration помогает описывать многоконтейнерные приложения в Docker Compose: сервисы, сети, тома, healthcheck и порядок запуска. CX Codex +1 3 000установок

Из того же набора106

Весь набор →
ux-designer Скилл ux-designer для ИИ-агентов: проводит проект от информационной архитектуры до передачи в разработку, с проверкой доступности и юзабилити. CX Codex +1 148установок responsive-images Скилл responsive-images внедряет адаптивные изображения с srcset, современными форматами AVIF и WebP, защищая от сдвигов верстки CLS и ускоряя LCP. CX Codex +1 148установок tanstack-virtual Скилл учит агента виртуализировать длинные списки, таблицы и сетки на TanStack Virtual: в DOM остаются только видимые строки. CX Codex +1 148установок de-slopify Скилл de-slopify для Claude Code находит шаблонные обороты, лишние тире и следы ИИ в комментариях при правке текста и кода после языковой модели. CX Codex +1 146установок chrome-devtools Скилл chrome-devtools управляет настоящим Chrome через расширение или DevTools MCP: заполняет формы, читает страницы и помогает отлаживать веб-приложения. Работает с активной сессией браузера. CX Codex +1 145установок hydration-guardian Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок e2e-testing Скилл e2e-testing помогает ИИ-агенту проектировать архитектуру E2E-тестов на Playwright: от Page Object Model и шардинга в CI до моков сети и проверок доступности. CX Codex +1 142установок valkey Скилл помогает настраивать Valkey и Redis-совместимое хранилище: от кэша и лимитов запросов до очередей и миграции с Redis. Пригодится при проектировании схемы данных и Docker Compose. CX Codex +1 142установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой