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