borghei/Claude-Skills / engineering/docker-development
docker-development
FlaggedAnalyse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.1 KB |
| examples/Dockerfile.sample | other | 1.9 KB |
| examples/docker-compose.sample.yml | config | 3.0 KB |
| examples/docker-compose.sound.yml | config | 787 B |
| references/docker-best-practices.md | markdown | 2.8 KB |
| scripts/compose_validator.py | script | 17.1 KB |
| scripts/dockerfile_analyzer.py | script | 15.2 KB |
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"]
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 469k | Updated | Claude CodeCodex | Verified | Install |
| 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: 469k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |