Führe und verwalte Docker Agents mit verschiedenen Safety Modes, Sandbox-Isolation, git worktrees und Command Aliases.
- GitHub Stars
- 626
- Dateien
- 6
- Letzter Commit
- 10. Nov. 2026
- Lizenz
- Apache-2.0
- Erlaubte Tools
- —
Was macht der docker-agent-run Skill?
Führe und verwalte Docker Agents mit verschiedenen Safety Modes, Sandbox-Isolation, git worktrees und Command Aliases.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den docker-agent-run skill
Diese Skill ermöglicht es Entwicklern, die Ausführung und den operativen Lebenszyklus von Docker Agents zu verwalten. Sie bietet die Tools, um Agents über den Befehl 'docker agent run' unter Verwendung von lokalen Configs, Registry-Referenzen oder vordefinierten Aliases aufzurufen. Nutzer können steuern, wie viel Autonomie ein Agent während der Tool Calls hat, indem sie aus verschiedenen Safety Modes wählen – von strikten Genehmigungsanforderungen bis hin zur vollautonomen Ausführung.
Wenn Sicherheit Priorität hat, ermöglicht diese Skill das Ausführen von Agents innerhalb einer isolierten MicroVM über das Sandbox-Flag. Diese Isolation erfordert das sbx CLI und erlaubt eine granulare Netzwerksteuerung über eine Allowlist. Entwickler können zudem git worktrees nutzen, um die Dateimodifikationen eines Agents von ihrem Haupt-Workspace zu trennen, oder den 'doctor'-Befehl verwenden, um Probleme mit der Model-Verfügbarkeit und den Credentials zu diagnostizieren. Diese Skill ist speziell darauf ausgelegt, bestehende Agents auszuführen und Fehler zu beheben, anstatt deren Konfigurationen zu erstellen.
Was ein agent damit machen kann
- 1Autonomie-Level des Agents konfigurierenRichte einen Agent so ein, dass er automatisch alle Tool Calls verweigert, die nicht explizit als sicher für unbeaufsichtigte Aufgaben markiert sind.
- 2Agent-Aktivitäten in einer Sandbox isolierenFühre einen Agent innerhalb einer MicroVM aus, um sicherzustellen, dass sein Filesystem und seine Prozessaktivitäten isoliert bleiben.
- 3Fehler bei der Agent-Ausführung diagnostizierenPrüfe, ob Model-Credentials oder die Verfügbarkeit des Providers die Ursache für einen fehlgeschlagenen Agent-Run sind.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den docker-agent-run Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den docker-agent-run Skill in Plugin installieren
/plugin marketplace add docker/skills /plugin install docker-skills@docker
Den docker-agent-run Skill in Claude Code installieren
~/.claude/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.claude/skills/docker-agent-runDen docker-agent-run Skill in Claude Code (project) installieren
.claude/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run .claude/skills/docker-agent-runDen docker-agent-run Skill in Codex installieren
~/.agents/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.agents/skills/docker-agent-runDen docker-agent-run Skill in Gemini CLI installieren
~/.gemini/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.gemini/skills/docker-agent-runDen docker-agent-run Skill in Claude.ai installieren
npx degit docker/skills/skills/docker-agent-run docker-agent-run && zip -r docker-agent-run.zip docker-agent-run # claude.ai → Customize → Skills → + → Create skill → Upload a skill → docker-agent-run.zip
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbardocker/skills/skills/docker-agent-run is public and reachablegithub.com/docker/skills/tree/HEAD/skills/docker-agent-run ↗Bestanden
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-11-10github.com/docker/skills/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 155 linesgithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗Bestanden
SKILL.md
Auf GitHub ansehenDocker Agent: Running and Operating Agents
Overview
This skill owns the operational side of Docker Agent: invoking docker agent run against a local config, an alias, or a registry reference; choosing how
much autonomy the agent gets over tool calls; isolating it in a sandbox VM;
and diagnosing why a run fails. It assumes the agent.yaml already exists —
see Related skills for authoring it.
When to use this skill
Activate this skill when:
- The user wants to run an agent interactively or headlessly (
--exec). - The user is choosing or debugging
--safety,--yolo, or approval behavior for tool calls. - The user wants to isolate an agent's shell/filesystem access with
--sandbox, or hit a sandbox network-policy error. - The user wants a reusable shortcut (
docker agent alias), a scoped git worktree (--worktree), or is debugging credentials/model availability (docker agent doctor).
Do not use this skill when
Do not use this skill when:
- The task uses standalone
sbx run/create/stop/rmrather thandocker agent run --sandbox— usedocker-sandboxes-lifecycle. - The task is standalone
sbx policyorsbx secretconfiguration — usedocker-sandboxes-network-credentials. Establish which CLI is in use before recommending commands when the request only says "my sandbox". - The task is writing or editing the
agent.yamlitself (models, toolsets, sub_agents) — usedocker-agent-config. - The task is exposing an agent as a server (
serve), sharing it via a registry (share), or evaluating it (evaluation sessions,--baselineregression gates) — usedocker-agent-deploy.
Core guidance
Safety modes
docker agent runsupports four--safetymodes; choose the least permissive one that still lets the task finish:strict— ask for approval before every tool call.balanced— auto-approve calls classified as safe, ask for the rest.restricted— auto-approve safe calls, deny the rest outright. Use for unattended/CI runs where no human can answer a prompt.autonomous— approve everything automatically. Equivalent to--yolo.
- Never default an unattended run (cron, CI, a server endpoint) to
autonomous/--yolo. Userestrictedfor unattended runs so an unexpected tool call fails closed instead of running unreviewed; reserveautonomous/--yolofor a sandboxed or fully trusted interactive session.# CI-safe: unreviewed tool calls are denied, not silently approved. docker agent run --exec --safety restricted ./agent.yaml "Triage the failing test" - Bake a safety default into an alias so callers don't have to remember it,
and note that an explicit CLI
--safety/--yoloondocker agent runstill overrides the alias:docker agent alias add safe-coder myorg/coder --safety balanced
Sandbox isolation
--sandboxruns the agent inside an isolated microVM managed by thesbxCLI (a separate prerequisite — install and configure it first). All shell, filesystem, and process activity started by built-in toolsets happens inside the VM; only the working directory (and, unless--no-kit, a staged "kit" of skills/prompt files) is mounted in. Exception: a local stdio MCP server declared on the agent runs as a host process outside the sandbox VM — treat any such MCP server as a trusted host integration, not a sandboxed one.docker agent run --sandbox ./agent.yaml- The sandbox network proxy is default-deny: only the model provider,
models.dev, and hosts the toolset resolver can infer are open. A custom MCP server or third-party API often needs an explicit allowlist entry — add it permanently rather than re-discovering it every run:docker agent sandbox allow api.example.com docker agent sandbox list docker agent sandbox deny api.example.com - Prefer baking
runtime: {sandbox: true}into the agent's ownagent.yamlover remembering--sandboxon every invocation of that agent; an explicit--sandbox=falseon the CLI still overrides the config default for a single debug run. - Sandboxes persist and are reused across runs from the same workspace — they are not torn down when the session ends. Don't expect a clean VM on every run; if you need one, change the mount set (e.g. a new kit) to force recreation.
Aliases and default agent
- Register a shortcut once, then run it by name instead of a path:
docker agent alias add code myorg/notion-expert docker agent run code - For a local run with no agent argument,
docker agent rundiscoversdocker-agent.yaml, thendocker-agent.yml, thendocker-agent.hclin the current directory (first match wins). Only if none exists does it resolve thedefaultalias, falling back to the built-in default agent. Theagent.yamlexamples in these skills pass a filename explicitly;agent.yamlis not an auto-discovery name. - Set the fallback for directories without a project config with a
defaultalias. To select it even when a project config exists, passdefaultexplicitly:docker agent alias add default ./my-agent.yaml docker agent run default - CLI flags on
docker agent run <alias>always override the alias's own stored options (e.g.docker agent run yolo-coder --yolo=false).
Worktrees
- Use
--worktree(-w) to isolate an agent's file edits from your current checkout — it runs the agent inside a fresh git worktree. For an interactive session, a clean worktree (no uncommitted changes, untracked files, or new commits) is removed automatically when the session ends; one with work prompts you to keep or remove. A headless run (--exec) never auto-cleans its worktree, regardless of state — it is left in place for inspection:docker agent run ./agent.yaml --worktree=auth-refactor --worktree-base origin/main --worktreecannot be combined with--remoteor--sandbox. To resume a worktree run, pass--session -1(or the session id) — do not re-pass--worktree, which fails because the worktree already exists.
Troubleshooting
- "No model is currently available" or "model ... is not pulled" means the
agent's provider has no usable credential, or (for
dmr/) the model hasn't been pulled. Rundocker agent doctor ./agent.yamlfirst — it reports the resolved model/provider and whether credentials were found — before touching the YAML. If credentials are missing, export the provider's API key; if a DMR model is missing, rundocker model pull <model>. Rerundoctorbefore retrying the task. - An agent that only describes a plan instead of executing it is usually
missing the tool it needs (add
type: shellortype: todoinagent.yaml), not a model failure — hand this back todocker-agent-config. - A
403 Blocked by network policyerror inside a sandbox run means the destination isn't allowlisted; usedocker agent sandbox allow <host>.
Related skills
- For standalone
sbxlifecycle commands, usedocker-sandboxes-lifecycle. - For standalone
sbx policyandsbx secret, usedocker-sandboxes-network-credentials. - For writing or changing the underlying
agent.yaml(models, toolsets, sub_agents), usedocker-agent-config. - For serving, sharing, or evaluating the agent, use
docker-agent-deploy.
References
references/safety-and-sandbox.md— full safety-mode/flag interaction table and sandbox trust-boundary details.references/sources.md— provenance of every rule in this skill.
Assets
- None.
Checks
checks/verification.md— Verification runbook for adocker agent runinvocation.
Dateien in diesem Skill
6docker-agent-run Skill-Fragen
Wie installiere ich den docker-agent-run Skill in Claude Code?
Führe npx degit docker/skills/skills/docker-agent-run ~/.claude/skills/docker-agent-run aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den docker-agent-run Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Welche verschiedenen Safety Modes gibt es zum Ausführen eines Docker Agents?
Es gibt vier Modi: strict (bestätigt jeden Tool Call), balanced (bestätigt sichere Aufrufe), restricted (verweigert nicht klassifizierte Aufrufe) und autonomous (bestätigt alles).
Was soll ich tun, wenn ich die Fehlermeldung 'No model is currently available' erhalte?
Führe 'docker agent doctor' aus, um zu diagnostizieren, ob der Provider über nutzbare Credentials verfügt oder ob das Model erst gepullt werden muss.
Wie erlaube ich einem Agent im Sandbox-Modus den Zugriff auf eine spezifische API?
Nutze den Befehl 'docker agent sandbox allow', um den Host zur Network Allowlist hinzuzufügen.