container-audit

Audit Dockerfiles and docker-compose files for security defects across six weighted dimensions.

6|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/greglas75/zuvo --skill container-audit-greglas75
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: container-audit
Source: https://github.com/greglas75/zuvo/tree/main/skills/container-audit
Command: npx skills add https://github.com/greglas75/zuvo --skill container-audit-greglas75

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Container configurations often ship with serious security flaws — images running as root, mutable :latest base tags, secrets baked into layers, and exposed Docker sockets — that go unnoticed until deployment. This Skill statically audits Dockerfile, Containerfile, and docker-compose files as code, catching these defects before they reach production without requiring Docker, a daemon, or network access. ## Core Features & Use Cases - Six-dimension security scoring: Evaluates base image pinning (K1), privilege and runtime hardening (K2), secret and build-context hygiene (K3), image minimalism (K4), known CVEs via Trivy/Grype (K5), and compose orchestration hardening (K6), producing a HEALTHY to CRITICAL grade with critical gates. - Static-first, CI-safe operation: Parses Dockerfiles and compose files (including override merges) with zero Docker and zero network; the CVE scan runs only when Trivy or Grype is present and degrades to N/A otherwise. - Safety gates: Read-only operation, automatic secret value censorship in reports, and explicit consent before any image pull. - Use Case: Before shipping a Dockerized service, run the audit to discover that your final stage lacks a USER directive and your compose file mounts /var/run/docker.sock, then receive a prioritized remediation roadmap with file:line citations. ## Quick Start Ask the AI to run a container security audit on the current project and report the score, critical findings, and remediation steps.

Frequently Asked Questions about container-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a Dockerfile for security issues?

Run the container audit against your project root or a specific Dockerfile path. It checks base image pinning, non-root users, secrets in ENV/ARG, image minimalism, and compose hardening, then produces a scored report with file:line findings and fixes.

Does this container audit require Docker to be installed?

No, the audit is static-first and parses Dockerfile and compose files as text with zero Docker and zero network access. It never connects to the Docker daemon or socket, making it safe to run in CI environments.

Can I scan container images for CVEs with Trivy or Grype?

Yes, if Trivy or Grype is installed, the K5 dimension scans declared base images for known CVEs. Image pulls require explicit consent; without a scanner or consent, K5 degrades to N/A and is excluded from scoring.

What is the difference between container-audit and infra-audit?

container-audit statically analyzes Dockerfile and compose files as code, while infra-audit inspects the live Docker daemon on a remote host over SSH. Use container-audit before shipping images and infra-audit for running infrastructure.

Why does the audit fail even with a decent score?

Critical gates fire on specific findings regardless of numeric score: a final image on a `:latest` tag, running as root, `privileged: true`, or a baked-in secret each trigger an overall FAIL. A dimension score of zero is sufficient but not required.

Does the audit support Kubernetes manifest scanning?

Dimensions K7-K10 are reserved for Kubernetes manifest, RBAC, Pod Security, and network policy checks behind the `--k8s` flag, but the check logic is not yet implemented. Current runs audit K1-K6 only and report K7-K10 as reserved.