docker-check

Audit Dockerfiles and docker-compose files for misconfigurations and security gaps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/rayvoidx/social-trend-agent --skill docker-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-check
Source: https://github.com/rayvoidx/social-trend-agent/tree/main/.claude/skills/docker-check
Command: npx skills add https://github.com/rayvoidx/social-trend-agent --skill docker-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits Docker configurations and docker-compose setups to ensure multi-stage builds, health checks, non-root usage, and image optimization.

Core Features & Use Cases

  • Multi-stage Builds: Detect and recommend multi-stage builds.
  • Health Checks: Verify HEALTHCHECK presence and correctness.
  • Security & Size: Ensure non-root users and minimal base images; recommend .dockerignore; remove unnecessary packages.
  • Output Report: Produce a Docker Health Report.

Quick Start

Run the docker-check skill to analyze Dockerfiles and docker-compose files in the repo.

Frequently Asked Questions about docker-check

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

FAQPage Schema
How do I audit Dockerfiles and docker-compose files for security and performance issues?

Docker-check audits your Dockerfile and docker-compose configurations to detect security gaps, misconfigurations, and optimization opportunities. It scans for multi-stage builds, HEALTHCHECK directives, non-root user setup, .dockerignore presence, unnecessary packages, build-time secrets exposure, and base image choices, then generates a structured report with findings and actionable recommendations.

What Docker configuration best practices does this tool check for?

The tool validates multi-stage builds to reduce image size, HEALTHCHECK presence for container health monitoring, non-root user configuration for security, .dockerignore files to exclude unnecessary files, minimal base images (slim or alpine variants), and removal of unnecessary packages. It flags misconfigurations and provides remediation guidance.

Can I use this to scan docker-compose setups alongside individual Dockerfiles?

Yes. Docker-check analyzes both Dockerfiles and docker-compose.yaml files at the repository level, auditing your complete Docker setup including service configurations, and produces a unified Docker Health Report with findings across all configurations.

What output does docker-check produce after analyzing my Docker configurations?

Docker-check generates a remediation-ready Docker Health Report containing findings with severity levels and actionable recommendations. The report is structured to highlight security gaps, performance bottlenecks, and optimization opportunities specific to your configurations.

Do I need existing Docker knowledge to interpret the audit results?

The tool produces recommendations targeting practitioners already working with Docker configurations. Understanding Dockerfile syntax, docker-compose structure, and basic container security concepts helps you act on findings, though the report itself flags specific issues with clear remediation steps.