AGENT DEVELOPMENT / docker
Docker Agent Configuration
Build Docker Agent configurations with per-agent toolsets, provider credentials, delegated teams and bounded autonomy.
“Use this skill when creating or editing an agent.yaml (or .yml/.hcl) configuration file for Docker Agent (cagent), including defining agents, models/providers, built-in or MCP toolsets, multi-agent teams with sub_agents. Even if the user just says they want to "build an AI agent with Docker", "make a coding agent config", "add a tool to my agent", or "set up a team of agents", this skill applies. Covers agent properties (model, instruction, toolsets, sub_agents, fallback), the models/providers sections, built-in toolsets (filesystem, shell, think, todo, memory, fetch), MCP toolset references, and named commands.”
01 / THE REASONING
Why this made the selection.
- It writes a Docker Agent agent.yaml, including models, toolsets, and sub-agents, and it does not cover running or serving the agent.
- API keys stay out of the file, and a local dmr model is the path that needs no credential.
- Specifies configuration-file ownership separately from run/serve workflows.
- Includes a reviewer restricted with readonly rather than assuming a filesystem toolset is read-only.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/docker-agent-config/SKILL.md
- skills/docker-agent-config/assets/team-agent.yaml
- README.md
- LICENSE
Our findings
- The overview says the skill owns agent.yaml and does not cover invoking the CLI or serving the config.
- Provider credentials come from the environment or docker agent setup; the file says never to hardcode an API key.
- dmr is the local provider with no API key, for agents that must not send data to a third party.
- readonly true restricts every toolset to read-only tools, and the skill does not itself run the agent.
- Inspected team asset gives shell access to coder and readonly filesystem access to reviewer.
- Definition distinguishes isolated sub-agent delegation from a named command that switches the active agent.
Not established by this review
- The resource was not executed and its tools were not called.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add docker/skills/skills/docker-agent-config Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/docker/skills/tree/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-agent-config - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Inspect the actual CLI version and choose model/provider entries and toolsets for each agent.
- Set appropriate iteration limits, retain reviewer readonly and configure credentials through supported mechanisms.
Before you start
- Docker Agent CLI plugin
- Chosen provider/model access or local model runtime
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Pinned skill definition ↗Checked
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-agent-config/SKILL.md
Supports: summary, whySelected, bestFor, limitations, install, access, review
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md
Supports: install
- Apache-2.0 licence ↗Checked
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE
Supports: license
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-agent-config/assets/team-agent.yaml
Supports: review, limitations, access, install
https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-agent-config/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt