← Explore all skills

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.

Upstream setup instructions ↗

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
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Inspect the actual CLI version and choose model/provider entries and toolsets for each agent.
  3. 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.

  1. 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

  2. https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md

    Supports: install

  3. Apache-2.0 licence ↗Checked

    https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE

    Supports: license

  4. https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-agent-config/assets/team-agent.yaml

    Supports: review, limitations, access, install

  5. https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-agent-config/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

Evidence & Ask