Skip to content

agent.3md documentation

One 3md file is a whole agent. Plane 0 is the agent (identity and rules); every other plane is a skill. A skill can bind to a real CLI command whose typed inputs are its arguments, so routing a request is route, fill, run; skills that are not command-shaped carry no command and are pure guidance. These docs cover the format, the CLI, the loaders, and the MCP server.

Getting started

  • What is agent.3md? - One 3md file is a whole agent: identity plus on-demand, often CLI-backed skills.
  • Quickstart - Install, scaffold an agent, route a request, and run the command it maps to.

The format

  • Skills and the format - Frontmatter, identity and skill planes, typed inputs, tool command templates, dependencies, and guidance-only skills.

Reference

  • CLI reference - The agent3md CLI: manifest, route, get, resolve, run [--exec], validate.
  • Loaders - The TypeScript reference loader plus the Rust and Swift loaders, all on the canonical 3md parser.
  • MCP server - Serve an agent's skills to any MCP client as tools (list, route, get, resolve).
  • Conformance and spec - The agent3md/1 spec, the validator, and the language-agnostic conformance vectors.