Use this skill when a user asks you to operate dc, inspect its API commands, or find the right generated command for an API task.
Workflow
- Search for candidates with
dc search "<intent>" --json; use--limitwhen needed. Search is only candidate discovery. - Inspect the exact command with
dc commands show <path...> --jsonbefore executing an unfamiliar command. - If the command detail has
auth.required=true, rundc auth status --hostname <host>before execution. If it is not logged in, stop and ask the user to authenticate. - Execute only after flags, body, auth, HTTP path, and output hints are clear from
commands show.
General Commands
dc commands --json: full generated command catalog.dc commands --include-hidden --json: include hidden generated commands.dc commands show <path...> --json: source of truth for one command.dc commands schema --json: catalog schema version for parser compatibility.dc search "<intent>" --json: ranked candidate commands.
References
- Read
references/catalog.mdfor the command discovery protocol and catalog field meanings. - Read
references/modules/container-management.mdfor thecontainer-managementmodule command index. - Read
references/modules/global-management.mdfor theglobal-managementmodule command index.
Rules
- Do not guess flags or request body shape from command names.
- Do not execute directly from search results; confirm with
commands showfirst. - Prefer
-o jsonfor machine-readable command output unless the user asks for human-readable output. - Use
--file,--set, or--set-strfor JSON request bodies according tocommands showbody requirements.