Subagents

What the agent does, shown to the main Agent when it picks a sub-agent. Write it to guide delegation decisions

Denylist with the same syntax and matching rules, applied after `tools`

Unique kebab-case identifier; defaults to the file name without its extension. A file with a missing or non-kebab-case name is skipped with a warning

Whether the file may replace a same-name built-in Agent; defaults to `false`. `--agent-file` does not need it

Sub-agent allowlist, same syntax as `tools`. Omit to inherit the built-in default (`coder`, `explore`, `plan`); a lone `*` allows every type. The main agent's effective list also includes every discovered custom agent

Tool allowlist (`Read`, `Bash`); MCP tools match as globs (`mcp__github__*`). YAML list or comma-separated string; omit or use a lone `*` to allow all tools, `tools: []` disables all tools

Extra hint describing when the agent should be used