JosiahSiegel/docker-watch-mode-2025
plugins/azure-to-docker-master/skills/docker-watch-mode-2025/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add JosiahSiegel/claude-plugin-marketplace docker-watch-mode-2025Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 7:56 AM144.5s1 file scanned
SKILL.md
- name:
- docker-watch-mode-2025
- description:
- |
- 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
- Confirm the app already starts with
docker compose upbefore adding watch rules. - Prefer
syncfor source directories when the runtime already reloads files. - Use
rebuildfor dependency manifests, Dockerfiles, compiled artifacts, or base-image changes. - Use
sync+restartfor configuration files that are read only at process startup. - Add narrow
ignorerules for dependency folders, build outputs, VCS folders, caches, secrets, and generated files. - Run
docker compose up --watchand verify both fast source edits and dependency changes.
Usage
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
syncfrom manifestrebuildrules. - 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
Related Skills
JosiahSiegel/clerk-sessions-webhooks-security
development
VerifiedTrustedCommunity
Use for Clerk sessions, tokens, webhooks, orgs, and security. PROACTIVELY activate for session tokens, JWT templates, getToken(), custom claims, pending sessions, multi-session UX, organizations, roles, permissions, system vs custom permissions, features/plans, MFA/passkeys/password policy/bot protection, Clerk webhooks, Svix signatures, verifyWebhook(), user/org sync, retries/replays, environment variables, custom domains, secret rotation, logs, and auth security reviews. Provides token semantics, webhook idempotency, authorization defaults, and hardening checklist.
45SKILL.mdUpdated Jun 19, 2026
JosiahSiegel/clerk-nextjs-auth
tools
VerifiedTrustedCommunity
Use for Clerk in Next.js. PROACTIVELY activate for @clerk/nextjs setup, App Router auth()/currentUser(), clerkMiddleware(), proxy.ts/middleware.ts, createRouteMatcher(), protected pages/layouts/Route Handlers/Server Actions/API routes/tRPC, auth.protect() role/permission/token checks, ClerkProvider placement, server-only clerkClient, Link prefetch, redirects, 401/404 auth failures, custom domains, __clerk proxy paths, and deployment gotchas. Provides file patterns, server/client boundary rules, matcher templates, and production checks.
45SKILL.mdUpdated Jun 19, 2026
JosiahSiegel/clerk-frontend-sdks
development
VerifiedTrustedCommunity
Use for Clerk frontend auth flows. PROACTIVELY activate for React, JavaScript, Vue, Nuxt, Astro, Expo, React Router, TanStack React Start, or SPA setup; ClerkProvider and publishable-key wiring; SignIn/SignUp/UserButton/UserProfile/OrganizationSwitcher; custom useUser/useAuth/useClerk/useSignIn/useSignUp/useSession/useOrganization flows; multi-session UX; cross-origin getToken() fetches; loading states, redirects, routing, CORS/cookies, or hydration bugs. Provides SDK selection, UI patterns, token-fetch templates, and frontend gotchas.
45SKILL.mdUpdated Jun 19, 2026
JosiahSiegel/clerk-environments-deployment
development
VerifiedTrustedCommunity
Use for Clerk dev/prod readiness, deployment, and multi-language implementation planning. PROACTIVELY activate for environment variables, pk_test/sk_test vs pk_live/sk_live, local dev, preview/staging/prod instances, domains/DNS, redirects, OAuth credentials, custom domains/proxy, authorizedParties, CSP, CORS/cookies, webhooks/tunnels, Vercel/Netlify/Cloudflare/API gateways, monitoring/troubleshooting, and backends in Node/Express/Fastify, Python/FastAPI/Django/Flask, Go, Ruby/Rails, Java/Spring, .NET, PHP/Laravel. Provides checklists, rollout plans, and language-portable patterns.
45SKILL.mdUpdated Jun 19, 2026