docker-pro SKILL.md skillA

docker-pro from bretfisher/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bretfisher/skills/docker-pro@git:20261104.e27cb65

Pins git:20261104.e27cb65 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bretfisher/skills
Path
plugins/devops/skills/docker-pro/SKILL.md
Versions recorded
1
Latest version
git:20261104.e27cb65, committed Nov 4, 2026
Size
15,111 bytes
Repository stars
21
License
MIT

Create, edit, and modernize Dockerfiles, .dockerignore, Docker Bake files, and Compose files using Bret Fisher's strongly opinionated modern Docker + BuildKit rules. Use this skill whenever the user asks about a Dockerfile, containerizing or "dockerizing" an app, base image choice, digest/SHA pinning of image tags, multi-stage builds, BuildKit, build caching or secrets, .dockerignore, docker-bake.hcl / `docker buildx bake`, hardened or distroless images…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Modern Docker & BuildKit Rules

Use this skill when creating, editing, reviewing, or modernizing any Docker build or run files: `Dockerfile`, `.dockerignore`, `docker-bake.hcl`, and `compose.yaml`. Be strongly opinionated and apply these defaults proactively, unless the repository already has clear conflicting conventions or the user explicitly asks for a different tradeoff.

These rules assume **BuildKit** is the builder (the default in modern Docker Engine and in `docker buildx`). That assumption is what lets us use every modern frontend feature below without guarding for legacy builders.

## Working Style

1. Inspect the repo before writing. Detect the language/runtime, package manager, lockfiles, build output dir, and any existing Docker files so your output matches reality instead of a generic template.
2. Prefer the smallest correct change, but don't preserve legacy patterns (no `version:` in compose, secrets baked into layers, `apt-get` without cache mounts) when you're already editing that file.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bretfisher/skills/docker-pro@sha256:1c2efcb956830944

The line at the top of this page pins the label git:20261104.e27cb65, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_5vx7ctv6tzathkmr.svg)](https://markdownregistry.com/a/art_5vx7ctv6tzathkmr)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Nov 4, 2026.

versioncommittedcommitsizeaudit
git:20261104.e27cb65 latest2026-11-04 e27cb65 15,111 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15111 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

bretfisher/skills · 21 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5vx7ctv6tzathkmr
GET https://markdownregistry.com/api/v1/resolve?ref=bretfisher/skills/docker-pro
GET https://markdownregistry.com/api/v1/blob/1c2efcb956830944d5bc790f9bccf5d5e91b8fd518679d58dbd82bca2ef0156f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from bretfisher/skills

skill-creator SKILL.md skill
bretfisher/skills · .agents/skills/skill-creator/SKILL.md · Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a…
git:20260608.879e4b9 · audit A · 21 stars
AGENTS.md AGENTS.md file
bretfisher/skills · AGENTS.md
git:20261106.9ca18d3 · audit A · 21 stars
CLAUDE.md CLAUDE.md file
bretfisher/skills · CLAUDE.md
git:20260608.c4a648b · audit B · 21 stars
CLAUDE.md@evals/super-linting/fixtures/py-claude CLAUDE.md file
bretfisher/skills · evals/super-linting/fixtures/py-claude/CLAUDE.md
git:20261011.fb45e06 · audit B · 21 stars
gha-audit SKILL.md skill
bretfisher/skills · plugins/devops/skills/gha-audit/SKILL.md · Audit the GitHub Actions workflows in this repo for security, speed, and correctness, and report findings with a…
git:20261104.e27cb65 · audit A · 21 stars
github-actions-workflow-pro SKILL.md skill
bretfisher/skills · plugins/devops/skills/github-actions-workflow-pro/SKILL.md · Create, edit, audit, and speed up GitHub Actions workflows using Bret Fisher's opinionated DevOps rules. Use it when…
git:20261104.8a9119a · audit A · 21 stars
k8s-catch-up SKILL.md skill
bretfisher/skills · plugins/devops/skills/k8s-catch-up/SKILL.md · Kubernetes features that reached beta or GA in v1.35 to v1.37 (Dec 2025 to Aug 2026), newer than most models' training…
git:20261104.e27cb65 · audit A · 21 stars
k8s-podspec-pro SKILL.md skill
bretfisher/skills · plugins/devops/skills/k8s-podspec-pro/SKILL.md · Writes and reviews Kubernetes pod specs against Bret Fisher's production floor (github.com/BretFisher/podspec) for…
git:20261107.73c7ca5 · audit A · 21 stars
super-linting SKILL.md skill
bretfisher/skills · plugins/devops/skills/super-linting/SKILL.md · Set up local development linting by picking the right linters for each file type a project uses, then recording them as…
git:20261104.e27cb65 · audit A · 21 stars
screencapture-mac SKILL.md skill
bretfisher/skills · plugins/utils/skills/screencapture-mac/SKILL.md · Captures the user's macOS screen, a window, or a region with the built-in `screencapture` CLI, then reads the image so…
git:20261104.e27cb65 · audit A · 21 stars

Every file in bretfisher/skills

Browse by kind, by grade A, or by owner.