Skip to content

borghei/Claude-Skills / engineering/docker-development

docker-development

Flagged

Analyse Dockerfiles and Compose files for security, image size, cache and config problems, with CI-ready exit codes. Use when reviewing or optimising a Dockerfile, validating docker-compose, or adding a container lint step.

examples/Dockerfile.sample

View on GitHub
# Dockerfile.sample — Dockerfile with common anti-patterns
#
# This Dockerfile contains deliberate bad practices for the Docker
# development skill scanner to detect:
#   - Using "latest" tag
#   - Running as root (no USER directive)
#   - No multi-stage build
#   - Installing unnecessary packages
#   - Not cleaning up apt cache
#   - COPY before dependency install (breaks caching)
#   - Using ADD instead of COPY for local files
#   - No HEALTHCHECK
#   - Exposing secrets in ENV
#   - Multiple RUN layers that should be combined

# ANTI-PATTERN: using "latest" tag — not reproducible
FROM node:latest

# ANTI-PATTERN: setting secrets in ENV (visible in image history)
ENV DATABASE_URL=postgres://admin:s3cretPass@db.internal:5432/appdb
ENV API_KEY=sk-prod-a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5

# ANTI-PATTERN: installing unnecessary debug/dev packages in production
RUN apt-get update
RUN apt-get install -y vim curl wget netcat telnet htop strace
RUN apt-get install -y python3 python3-pip
# ANTI-PATTERN: not cleaning apt cache — bloats image
# (missing: && rm -rf /var/lib/apt/lists/*)

WORKDIR /app

# ANTI-PATTERN: copying everything before installing dependencies
# This breaks Docker layer caching — any source change re-installs deps
COPY . .

RUN npm install

# ANTI-PATTERN: using ADD for local files (ADD has extra magic for URLs/tar)
ADD ./config/default.json /app/config/default.json
ADD ./scripts/entrypoint.sh /app/scripts/entrypoint.sh

# ANTI-PATTERN: multiple RUN layers that should be combined
RUN chmod +x /app/scripts/entrypoint.sh
RUN mkdir -p /app/logs
RUN mkdir -p /app/tmp
RUN mkdir -p /app/uploads

# ANTI-PATTERN: exposing too many ports without documentation
EXPOSE 3000
EXPOSE 3001
EXPOSE 9229
EXPOSE 8080

# ANTI-PATTERN: no HEALTHCHECK defined

# ANTI-PATTERN: running as root (no USER directive)
# (missing: USER node or USER 1001)

CMD ["node", "server.js"]
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall