PluginInstalls cleanly
Docker help for your app projects
Docker Skills
Official Docker skills that help your assistant put an app in a container, write Compose files, and ask before running Docker commands that delete things.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Build an app, Web developers
What it does
Docker is a tool that packs an app and everything it needs into a "container", so it runs the same way on your laptop, a friend's computer or a server. Setting it up means writing special files (a Dockerfile and a compose.yaml), and small mistakes there are common.
These 12 skills come from Docker itself. A skill is a text file that tells your assistant how to do one kind of job. These teach your assistant Docker's recommended way to:
- start a Docker setup for a project,
- build smaller and safer images,
- connect several containers (for example a website and its database) with Docker Compose.
A safety skill, docker-destructive-guardrails, tells the assistant to say what will be lost and ask you before it runs Docker commands that cannot be undone, such as deleting volumes where your data lives. It makes an exception for small, low-risk container clean-ups.
Other skills cover Docker Sandboxes (running an AI agent inside an isolated box) and Docker Agent. These are more advanced.
The plugin also adds a connection to Docker's documentation server on the internet (ai-backend-service.docker.com/mcp). The docker-docs skill uses it to answer Docker questions from the current docs. Without it, the skill reads pages from docs.docker.com. Docker added this on 19 October 2026, after the last release (v0.3.1). A plugin installed now includes it. The README says plugin updates arrive with a new release, so an older install may not have it yet. The skills install (npx skills add) adds no server.
The plugin adds no hooks. The skills need Docker installed on your computer; they do not install it.
Who it is for
People who build an app with an assistant and want to run it in Docker, or put it on a server later, without learning every Docker file by heart.
Example prompts
- "Put this project in a Docker container and explain each line of the Dockerfile."
- "Add a compose.yaml that starts my app and a Postgres database together."
- "My Docker image is very big. Make it smaller and tell me what you changed."
- "Why does docker compose up fail? Read the error and fix it."
- "Clean up old Docker images, but ask me before deleting anything."
How to install
/plugin marketplace add docker/skills/plugin install docker-skills@dockerHow to use it
Ask: Put this project in a Docker container and add a compose.yaml so I can start it with one command. The skills load by themselves when the task is about Docker.
Other assistants
Codex CLI (from the README). Start a new Codex session afterwards:
codex plugin marketplace add docker/skills
codex plugin add docker-skills@dockerGemini CLI (from the README). Restart Gemini CLI afterwards:
gemini extensions install https://github.com/docker/skillsSkills only, for any assistant, without the docs server. It asks which skills and which assistants:
npx skills add docker/skillsDo not use both the plugin and the skills install in the same assistant. We have not tested the Codex and Gemini routes.
Check it works
- In Claude Code, run
/pluginand check thatdocker-skillsis listed as installed. - Type
/and look for the skills, for example/docker-skills:docker-compose-patterns. - To see the skill list without installing, run
npx skills add docker/skills --list(README).
Common problems
- Skills do not show up in Codex or Gemini CLI — the session started before the install — start a new Codex session or restart Gemini CLI, as the README says.
- Docker commands fail with "command not found" or cannot connect — Docker itself is not installed or not running — install and start Docker Desktop first; the skills do not install Docker (our reading).
- The plugin does not load in Claude Code — follow the plugin troubleshooting steps in the Claude Code docs.
What to watch out for
- Runs shell commands: the assistant builds images and starts or stops containers on your computer; Docker must be installed, and you approve each command
- Sends data to Docker: the plugin and extension installs also add Docker's remote docs MCP server (ai-backend-service.docker.com/mcp), so documentation questions go to Docker; without it, the docker-docs skill fetches pages from docs.docker.com (README, docker-docs skill)
- Deleting containers, images or volumes can lose data; the docker-destructive-guardrails skill asks the assistant to confirm first, except small, low-risk container clean-ups, so read each command before you approve it
- Some skills are marked experimental (docker-docs, Docker Sandboxes environments and kits), so their steps may change
Licence and author
- Licence
- Apache-2.0
- Author
- Docker
- Source code
- github.com/docker/skills
How we tested it
We installed it on an empty test computer on 22 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not run: "codex plugin marketplace add docker/skills" (not a form the sandbox runs). Not run: "codex plugin add docker-skills@docker" (not a form the sandbox runs). Not run: "gemini extensions install https://github.com/docker/skills" (not a form the sandbox runs). No skill was used and Docker was not run. Not yet used on real work.
Technical details of the test
- Date
- 22 Oct 2026
- Method
- Intake sandbox run on 2026-10-22 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files, ran "npx -y skills --help"; installed docker-skills@docker with the Claude Code command line.
Checked again on 22 Oct 2026
Alternatives
- Render Claude plugin — deploys apps to Render's hosting instead of teaching Docker.
- Superpowers — general planning and build habits, nothing Docker-specific.
FAQ
Do I need to know Docker? No, but you need Docker installed. The skills help the assistant write the files. You approve the commands.
Does it cost money? The skills are free (Apache-2.0).
Which install should I use? The plugin line for your assistant. It updates through the assistant and adds the Docker docs connection. The skills install adds no connection.
Can it delete my data? Docker commands can. The guardrail skill asks for confirmation first, except for small container clean-ups. Claude Code also asks you before it runs a command, unless you turned that off.
Sources
- github.com/docker/skills
- github.com/docker/skills/blob/main/plugin-mcp.json
- github.com/docker/skills/blob/main/skills/docker-docs/SKILL.md
- github.com/docker/skills/blob/main/skills/docker-destructive-guardrails/SKILL.md
- docs.docker.com/ai/skills/install/