Add `dotagents skills <subcommand>` CLI

[dcramer]

Summary

Expose a dotagents skills CLI subcommand so agents can discover and fetch skill content inline — without knowing local file paths or relying on a pre-populated .agents/skills/ directory.

Motivation

Skills today are consumed by agents that read static files on disk. There is no programmatic surface for an agent to ask "give me the content of skill X" at runtime.

agent-browser demonstrates the right pattern: its SKILL.md instructs agents to call agent-browser <subcommand> directly, treating the CLI as the fetch primitive. The skill file is thin; the CLI does the heavy lifting. Agents get a stable interface and can compose across environments.

dotagents skills would give agents the same capability over skills themselves.

Proposed subcommands

• dotagents skills list — list available skills (name, description, source)
• dotagents skills fetch <name> — print the full skill content to stdout so an agent can read it inline
• dotagents skills show <name> — show skill metadata (source, path, version) without the full body

The exact surface can be shaped by implementation, but list and fetch are the minimum needed for agents to self-steer.

Prior art in this repo

• Skills Composition #123 (Skills Composition) and Separation between consuming and producing skills #125 (Separation between consuming and producing skills) both point at skills needing a richer runtime interface; a CLI subcommand would give composition and separation a clean integration point.

--

View Junior Session in Sentry