Subagent Authoring

Agents justify a separate definition through a distinct role, permission boundary, model, or isolated context. Put reusable procedures in skills instead of creating persona-only agents.

Definition and source

Define agents in .opencode/agents/<name>.md, ~/.config/opencode/agents/<name>.md, or the agent section of opencode.json. In a generated configuration repository, edit the source template and validate the rendered target; do not maintain both independently.

Common fields are:

• description: required routing summary.
• mode: primary, subagent, or all; defaults to all.
• model, temperature, top_p, steps, disable, and color: optional behavior settings.
• hidden: removes a subagent from user autocomplete, not programmatic invocation.
• permission: tool, Bash, skill, task, and external-directory access.