docker-best-practices

SKILL.md

Comprehensive Docker best practices for images, containers, and production deployments.

Covers base image selection (Wolfi/Chainguard, Alpine, Distroless), Dockerfile structure with optimal layer ordering, multi-stage builds, and layer optimization techniques to minimize image size and build time

Includes container runtime security patterns: running as non-root, dropping capabilities, read-only filesystems, resource limits, health checks, and logging configuration

Provides Docker Compose best practices for services, networks, volumes, environment variables, and dependency management with health check conditions

Details production strategies: semantic versioning, secrets management, monitoring with labels and health checks, backup procedures, and rolling update configurations

Covers platform-specific guidance for Linux, macOS, and Windows, plus performance optimization through BuildKit, cache mounts, and image size reduction

🚨 CRITICAL GUIDELINES

Windows File Path Requirements

MANDATORY: Always Use Backslashes on Windows for File Paths

When using Edit or Write tools on Windows, you MUST use backslashes (\) in file paths, NOT forward slashes (/).

Examples:

❌ WRONG: D:/repos/project/file.tsx

✅ CORRECT: D:\repos\project\file.tsx

This applies to:

Edit tool file_path parameter

Write tool file_path parameter

All file operations on Windows systems

Documentation Guidelines