Dockerfile Validator

This validator runs hadolint and Checkov against your Dockerfiles and classifies findings into Critical, High, Medium, and Low buckets. It skips reference docs if everything passes, which is a nice touch. The skill follows a strict execution order and includes fallback branches for when you're in a locked-down environment without Python or Docker. You get severity-based reporting that maps issues to specific reference files (security checklist, optimization guide, best practices). The deterministic flow and explicit fallback handling make it reliable in CI pipelines where tool availability varies. If you're reviewing Dockerfiles before merge or hardening images for production, this gives you structured output without the usual tool-chaining guesswork.

skills.sh installs: 786
GitHub stars: 337
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add akin-ozer/cc-devops-skills --skill dockerfile-validator --agent claude-code

Installs into .claude/skills of the current project.

Files

Dockerfile Validator

Validate Dockerfiles with deterministic stages, clear severity reporting, and explicit fallbacks when tools or network access are constrained.

Trigger Phrases

Use this skill when the user asks for tasks like:

"validate this Dockerfile"
"lint/check my Dockerfile"
"security scan Dockerfile"
"optimize Docker image size/build time"
"review Dockerfile before merge"
"find issues in Dockerfile.prod/Dockerfile.dev"

Use / Do Not Use

Use this skill for:

Syntax and lint validation
Security and secrets checks
Best-practice and performance review
Dockerfile hardening before CI/CD or production

Do not use this skill for:

Generating a new Dockerfile from scratch (use dockerfile-generator)
Running containers, debugging runtime behavior, or image registry operations

Local Files In This Skill

Validator script: scripts/dockerfile-validate.sh
References:
- references/security_checklist.md
- references/optimization_guide.md
- references/docker_best_practices.md
Example Dockerfiles: examples/*.Dockerfile