docker-watch-mode-2025 — скилл для Claude Code: hot reload в Compose
Скилл docker-watch-mode-2025 настраивает watch в Docker Compose: правки исходников уезжают в контейнер без пересборки, а манифесты зависимостей пересобирают образ.
MIT 166 установок ★ 66 обновлён 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a claude-codeЧто делает docker-watch-mode-2025
Скилл разбирает watch-режим Docker Compose: какому каталогу нужен sync, что отдавать в rebuild, а где хватит sync+restart. Внутри порядок действий из шести шагов, справочник по действиям и чек-лист для случаев, когда изменения не долетают до контейнера.
В примере YAML sync смотрит на ./frontend/src с ignore на node_modules/, .git/ и dist/, а для ./frontend/package.json заведено отдельное правило rebuild. Запуск — docker compose up --watch. Правила ignore скилл советует держать узкими: зависимости, артефакты сборки, кеши и секреты в синхронизацию пускать не надо.
Сначала убедитесь, что приложение поднимается обычным docker compose up — иначе добавлять правила watch нечего отлаживать. Для горячей перезагрузки внутри контейнера должен работать свой watcher: Compose только копирует файлы, подхватить их должно само приложение. Когда правила watch пересекаются с зависимостями сервисов, профилями или томами, скилл предлагает ставить рядом compose-patterns-2025.
Какие задачи решает
- перевести фронтенд на hot reload без bind mount всего проекта
- отделить синхронизацию исходников от пересборки при смене зависимостей
- исключить
node_modulesи артефакты сборки из наблюдаемых путей - найти причину, по которой правка файла не доходит до контейнера
- выбрать между
sync+restartи обычнымsyncдля конфигов
Примеры запросов агенту
- Настрой
watchдля сервисаfrontend:syncна./frontend/src,rebuildнаpackage.json. - Правка в
src/App.tsxне долетает до контейнера — пройдись по чек-листу из скилла. - Добавь
ignoreдляnode_modules/,.git/иdist/в правило синхронизации.
Как установить docker-watch-mode-2025
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a claude-code2Вручную: положить файлы
~/.claude/skills/docker-watch-mode-2025/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/docker-watch-mode-2025/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a codex2Вручную: положить файлы
.agents/skills/docker-watch-mode-2025/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a cursor2Вручную: положить файлы
.cursor/skills/docker-watch-mode-2025/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/azure-to-docker-master/skills/docker-watch-mode-20252Вручную: положить файлы
.github/skills/docker-watch-mode-2025/SKILL.md1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a gemini-cli2Командой платформы
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/azure-to-docker-master/skills/docker-watch-mode-2025Вручную: положить файлы
.devin/skills/docker-watch-mode-2025/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о docker-watch-mode-2025
Как установить docker-watch-mode-2025 в Claude Code?
Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a claude-code. Файл скилла появится по пути ~/.claude/skills/docker-watch-mode-2025/SKILL.md.
Что делает docker-watch-mode-2025?
Описывает три действия watch в Compose: sync для фреймворков с собственной перезагрузкой, rebuild для скомпилированных языков и изменений зависимостей, sync+restart для конфигов, которые читаются только при старте процесса.
Нужен ли nodemon, если есть Compose watch?
Да, если приложение само не следит за файлами. Watch только доставляет изменённые файлы в контейнер, перезапуск внутри делает уже сам рантайм, поэтому без своего watcher горячая перезагрузка не сработает.
Исходный текст
SKILL.md · MIT
---
name: docker-watch-mode-2025
description: |
Docker Compose Watch mode for hot reload during local development (2025 GA).
PROACTIVELY activate for: (1) docker compose watch setup, (2) watch action types (sync, rebuild, sync+restart, sync+exec), (3) configuring path filters and ignore patterns, (4) hot-reload for Node/Python/Go/Rust apps in Compose, (5) sync-only vs rebuild trade-offs, (6) using watch with profiles, (7) debugging watch mode (verbose logs), (8) integrating watch with bind mounts, (9) Compose watch vs nodemon/air/cargo-watch.
Provides: watch action reference, per-language hot-reload examples, path filter patterns, and troubleshooting steps.
---
# Docker Compose Watch Mode (2025 GA)
Docker Compose Watch enables automatic hot reload during local development by synchronizing file changes instantly without manual container restarts.
## Three Watch Actions
### 1. sync - Hot Reload
For frameworks with hot reload (React, Next.js, Node.js, Flask).
Copies changed files directly into running container.
### 2. rebuild - Compilation
For compiled languages (Go, Rust, Java) or dependency changes.
Rebuilds image and recreates container when files change.
### 3. sync+restart - Config Changes
For configuration files requiring restart.
Syncs files and restarts container.
## Core Procedure
1. Confirm the app already starts with `docker compose up` before adding watch rules.
2. Prefer `sync` for source directories when the runtime already reloads files.
3. Use `rebuild` for dependency manifests, Dockerfiles, compiled artifacts, or base-image changes.
4. Use `sync+restart` for configuration files that are read only at process startup.
5. Add narrow `ignore` rules for dependency folders, build outputs, VCS folders, caches, secrets, and generated files.
6. Run `docker compose up --watch` and verify both fast source edits and dependency changes.
## Usage
```yaml
services:
frontend:
build: ./frontend
develop:
watch:
- action: sync
path: ./frontend/src
target: /app/src
ignore: [node_modules/, .git/, dist/]
- action: rebuild
path: ./frontend/package.json
```
Start with: `docker compose up --watch`.
## Troubleshooting Checklist
- Change not detected: verify the watched path is relative to the Compose file and not excluded by `ignore`.
- Hot reload not firing: confirm the application inside the container has its own watcher enabled.
- Container restarts too often: split source `sync` from manifest `rebuild` rules.
- File ownership issues: prefer named volumes for dependency directories and sync only application code.
- Slow sync: narrow watched paths and exclude build outputs or large generated folders.
## References
Use `docker compose watch --help` and Docker's Compose Watch documentation for the current action set and CLI flags. Pair this skill with `compose-patterns-2025` when watch rules interact with service dependencies, profiles, networks, or volumes.
## Benefits
- Better performance than broad bind mounts
- Fewer host/container file permission issues
- Intelligent syncing with rebuild capability
- Works across supported Docker Desktop and Compose platforms
© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace