feat: adding new skills, including testing patterns and methodologies, along with bundled resources for better usability.

.claude/skills/devops/docker/templates/Dockerfile.node

@@ -0,0 +1,93 @@
+# =============================================================================
+# Multi-Stage Node.js Dockerfile
+# Usage:
+#   docker build -t myapp .
+#   docker run -p 3000:3000 myapp
+# =============================================================================
+
+# ---------------------------------------------------------------------------
+# Stage 1: Install dependencies
+# ---------------------------------------------------------------------------
+FROM node:22-slim AS deps
+
+# Enable corepack for pnpm support.
+RUN corepack enable
+
+WORKDIR /app
+
+# Copy only package manifests first for dependency layer caching.
+# Dependencies are only reinstalled when these files change.
+COPY package.json pnpm-lock.yaml ./
+
+# Install production and dev dependencies (dev deps needed for build step).
+RUN pnpm install --frozen-lockfile
+
+# ---------------------------------------------------------------------------
+# Stage 2: Build the application
+# ---------------------------------------------------------------------------
+FROM node:22-slim AS builder
+
+RUN corepack enable
+
+WORKDIR /app
+
+# Copy dependencies from the deps stage.
+COPY --from=deps /app/node_modules ./node_modules
+COPY --from=deps /app/package.json /app/pnpm-lock.yaml ./
+
+# Copy source code and config files needed for the build.
+COPY tsconfig.json ./
+COPY src/ ./src/
+# COPY public/ ./public/           # Uncomment for Next.js or static assets
+
+# Build the application.
+RUN pnpm build
+
+# Remove dev dependencies after build to reduce size.
+RUN pnpm prune --prod
+
+# ---------------------------------------------------------------------------
+# Stage 3: Production runtime
+# ---------------------------------------------------------------------------
+FROM node:22-slim AS runtime
+
+# Run as non-root for security.
+RUN groupadd -r appuser && useradd -r -g appuser -d /app -s /bin/false appuser
+
+WORKDIR /app
+
+# Set production environment.
+ENV NODE_ENV=production \
+    PORT=3000
+
+# Copy only production artifacts from the builder stage.
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./
+
+# For Next.js standalone output, use instead:
+# COPY --from=builder /app/.next/standalone ./
+# COPY --from=builder /app/.next/static ./.next/static
+# COPY --from=builder /app/public ./public
+
+# Switch to non-root user.
+USER appuser
+
+# Expose the application port.
+EXPOSE 3000
+
+# Health check -- adjust the endpoint to match your app.
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD node -e "fetch('http://localhost:3000/health').then(r => { if (!r.ok) process.exit(1) })" || exit 1
+
+# Run the application.
+CMD ["node", "dist/server.js"]
+
+# For Next.js standalone:
+# CMD ["node", "server.js"]
+
+# For NestJS:
+# CMD ["node", "dist/main.js"]
+
+# For Express with ts-node (dev only, not recommended for production):
+# CMD ["npx", "ts-node", "src/server.ts"]

.claude/skills/devops/docker/templates/Dockerfile.python

@@ -0,0 +1,78 @@
+# =============================================================================
+# Multi-Stage Python Dockerfile
+# Usage:
+#   docker build -t myapp .
+#   docker run -p 8000:8000 myapp
+# =============================================================================
+
+# ---------------------------------------------------------------------------
+# Stage 1: Build dependencies
+# ---------------------------------------------------------------------------
+# Use slim for building - it has gcc and headers available via apt.
+FROM python:3.12-slim AS builder
+
+# Prevent Python from writing .pyc files and enable unbuffered output.
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+# Install build-time system dependencies (if any compiled packages need them).
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install Python dependencies into a virtual environment.
+# Copying requirements first enables Docker layer caching --
+# dependencies are only reinstalled when requirements.txt changes.
+COPY requirements.txt .
+RUN python -m venv /app/.venv \
+    && /app/.venv/bin/pip install --no-cache-dir --upgrade pip \
+    && /app/.venv/bin/pip install --no-cache-dir -r requirements.txt
+
+# ---------------------------------------------------------------------------
+# Stage 2: Runtime
+# ---------------------------------------------------------------------------
+FROM python:3.12-slim AS runtime
+
+# Prevent .pyc files and enable unbuffered output for logging.
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PATH="/app/.venv/bin:$PATH"
+
+# Install only runtime system dependencies (no build tools).
+# Add packages here if your app needs them at runtime (e.g., libpq for psycopg).
+# RUN apt-get update && apt-get install -y --no-install-recommends \
+#     libpq5 \
+#     && rm -rf /var/lib/apt/lists/*
+
+# Create a non-root user for security.
+RUN groupadd -r appuser && useradd -r -g appuser -d /app -s /bin/false appuser
+
+WORKDIR /app
+
+# Copy the virtual environment from the builder stage.
+COPY --from=builder /app/.venv /app/.venv
+
+# Copy application source code.
+COPY src/ ./src/
+
+# Switch to non-root user.
+USER appuser
+
+# Expose the application port.
+EXPOSE 8000
+
+# Health check -- adjust the endpoint to match your app.
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" || exit 1
+
+# Run the application.
+# For FastAPI/Uvicorn:
+CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000"]
+
+# For Django/Gunicorn:
+# CMD ["gunicorn", "src.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
+
+# For a plain script:
+# CMD ["python", "-m", "src.main"]

.claude/skills/devops/docker/templates/docker-compose.dev.yaml

@@ -0,0 +1,100 @@
+# =============================================================================
+# Development Docker Compose
+# Usage:
+#   docker compose -f docker-compose.dev.yaml up
+#   docker compose -f docker-compose.dev.yaml down -v   # remove volumes too
+# =============================================================================
+
+services:
+  # ---------------------------------------------------------------------------
+  # Application
+  # ---------------------------------------------------------------------------
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: builder  # Use the build stage for dev (includes dev deps)
+    ports:
+      - "${APP_PORT:-3000}:3000"
+    environment:
+      NODE_ENV: development
+      DATABASE_URL: postgresql://postgres:postgres@postgres:5432/app_dev
+      REDIS_URL: redis://redis:6379/0
+    volumes:
+      # Mount source code for hot-reload. Exclude node_modules.
+      - .:/app
+      - /app/node_modules
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    # Override CMD for development (hot-reload).
+    command: ["pnpm", "dev"]
+    # For Python:
+    # command: ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "3000", "--reload"]
+
+  # ---------------------------------------------------------------------------
+  # PostgreSQL
+  # ---------------------------------------------------------------------------
+  postgres:
+    image: postgres:17-alpine
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: app_dev
+    volumes:
+      # Persist data across restarts.
+      - postgres_data:/var/lib/postgresql/data
+      # Run init scripts on first start.
+      # - ./scripts/init-db.sql:/docker-entrypoint-initdb.d/init.sql
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+  # ---------------------------------------------------------------------------
+  # Redis
+  # ---------------------------------------------------------------------------
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+    # Persist data to disk every 60 seconds if at least 1 key changed.
+    command: ["redis-server", "--save", "60", "1", "--loglevel", "warning"]
+
+  # ---------------------------------------------------------------------------
+  # Optional: pgAdmin (database GUI)
+  # ---------------------------------------------------------------------------
+  # pgadmin:
+  #   image: dpage/pgadmin4:latest
+  #   ports:
+  #     - "5050:80"
+  #   environment:
+  #     PGADMIN_DEFAULT_EMAIL: admin@local.dev
+  #     PGADMIN_DEFAULT_PASSWORD: admin
+  #   depends_on:
+  #     - postgres
+
+  # ---------------------------------------------------------------------------
+  # Optional: Mailpit (email testing)
+  # ---------------------------------------------------------------------------
+  # mailpit:
+  #   image: axllent/mailpit:latest
+  #   ports:
+  #     - "8025:8025"   # Web UI
+  #     - "1025:1025"   # SMTP
+
+volumes:
+  postgres_data:
+  redis_data: