minimus-dockerfile

Writes and migrates Dockerfiles onto Minimus distroless base images from reg.mini.dev.

20|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/minimusio/ai-integration --skill minimus-dockerfile-minimusio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minimus-dockerfile
Source: https://github.com/minimusio/ai-integration/tree/main/plugins/cursor/skills/minimus-dockerfile
Command: npx skills add https://github.com/minimusio/ai-integration --skill minimus-dockerfile-minimusio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Standard Dockerfiles built on Docker Hub or distro-based images (Ubuntu, Alpine, Debian) ship with large CVE counts and unnecessary bloat. This Skill guides an AI agent to author or migrate Dockerfiles onto Minimus hardened distroless images, reducing vulnerabilities while keeping builds working. ## Core Features & Use Cases - Dockerfile migration: Converts existing Dockerfiles to Minimus base images with a minimal diff, preserving valid WORKDIR, ENV, COPY, and CMD instructions. - Multi-stage build construction: Detects shell-less production images and builds a two-stage Dockerfile using the -dev variant for compilation and the production variant for runtime. - Package resolution: Replaces apt-get/apk add installs by discovering equivalent Minimus apk packages and installing them only in the build stage. - Build verification: Builds and runs the resulting image, mapping error signatures (missing shell, permission denied, manifest unknown) to the correct fix. - Use Case: A team wants to migrate a Node.js service from node:22 on Docker Hub to a hardened image. The Skill discovers reg.mini.dev/node:22, reads its runtime contract, writes a multi-stage Dockerfile, verifies the build, and reports the CVE reduction. ## Quick Start Migrate my existing Dockerfile to use a Minimus hardened base image and verify that it builds and runs.

Frequently Asked Questions about minimus-dockerfile

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

FAQPage Schema
How do I migrate a Dockerfile to a distroless base image?

Find the matching Minimus image on images.minimus.io, pin a supported version line, and read its runtime contract (User, WorkingDir, Entrypoint). Move all installs and compilation into a -dev build stage and copy artifacts into the shell-less production stage.

How do I reduce CVEs in my container images?

Switch the base image to a Minimus hardened image from reg.mini.dev, which ships with few to no known CVEs and daily rebuilds. The image's gallery page shows its CVE count and reduction versus the Docker Hub equivalent.

Why does my container fail with exec /bin/sh: no such file or directory?

The production Minimus image has no shell, so shell-form CMD or ENTRYPOINT cannot run. Switch to exec-form JSON arrays, or use a shell-bearing base like reg.mini.dev/busybox if shell features are genuinely required.

Can I use apt-get or apk add in a Minimus production image?

No, production Minimus images contain no package manager. Search for the equivalent apk package using reg.mini.dev/busybox:latest-dev, install it in the -dev build stage, and copy the artifacts into the runtime stage.

Do Minimus images require authentication to pull?

No, all discovery and pulls work anonymously with no login or token. Running docker login reg.mini.dev at runtime only raises pull rate limits for account holders and never changes the Dockerfile.