Reference

Agent TOML spec

Agents are the units of orchestration. Each one is a single TOML file declaring what it does, which skills it may call, and which tools it needs.

# agents/seo-supervisor.toml
id            = "seo-supervisor"
name          = "SEO Supervisor"
description   = "Routes /seo commands to the right skill graph."
model         = "gemini-2.5-pro"
triggers      = ["/seo *"]
skills        = ["seo-audit", "seo-page", "seo-cluster", "seo-local", "seo-geo"]
tools         = ["shell", "browser", "read_file", "write_file"]
mcps_optional = ["dataforseo", "firecrawl"]

[guardrails]
max_pages_crawled = 500
require_confirmation_for = ["file_delete", "shell_write_outside_workspace"]

[prompt]
template = "prompts/seo-supervisor.md"

Registry validation

Every id in skills = [...] must resolve to an existing SKILL.md. The build fails otherwise — no dangling references reach the user's install.

See also → MCP integration