133description: Description of when this subagent should be invoked133description: Description of when this subagent should be invoked
134tools: tool1, tool2, tool3 # Optional - inherits all tools if omitted134tools: tool1, tool2, tool3 # Optional - inherits all tools if omitted
135model: sonnet # Optional - specify model alias or 'inherit'135model: sonnet # Optional - specify model alias or 'inherit'
136permissionMode: default # Optional - permission mode for the subagent
137skills: skill1, skill2 # Optional - skills to auto-load
136---138---
137 139
138Your subagent's system prompt goes here. This can be multiple paragraphs140Your subagent's system prompt goes here. This can be multiple paragraphs
146#### Configuration fields148#### Configuration fields
147 149
148| Field | Required | Description |150| Field | Required | Description |
149| :------------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |151| :--------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
150| `name` | Yes | Unique identifier using lowercase letters and hyphens |152| `name` | Yes | Unique identifier using lowercase letters and hyphens |
151| `description` | Yes | Natural language description of the subagent's purpose |153| `description` | Yes | Natural language description of the subagent's purpose |
152| `tools` | No | Comma-separated list of specific tools. If omitted, inherits all tools from the main thread |154| `tools` | No | Comma-separated list of specific tools. If omitted, inherits all tools from the main thread |
153| `model` | No | Model to use for this subagent. Can be a model alias (`sonnet`, `opus`, `haiku`) or `'inherit'` to use the main conversation's model. If omitted, defaults to the [configured subagent model](/en/model-config) |155| `model` | No | Model to use for this subagent. Can be a model alias (`sonnet`, `opus`, `haiku`) or `'inherit'` to use the main conversation's model. If omitted, defaults to the [configured subagent model](/en/model-config) |
156| `permissionMode` | No | Permission mode for the subagent. Valid values: `default`, `acceptEdits`, `bypassPermissions`, `plan`, `ignore`. Controls how the subagent handles permission requests |
157| `skills` | No | Comma-separated list of skill names to auto-load when the subagent starts. Skills are loaded into the subagent's context automatically |
154 158
155### Model selection159### Model selection
156 160