Custom agents
Custom agents are specialist instructions a Session can delegate to. Results appear in bounded blocks.
What it is
Custom agents are specialist instructions a Session can delegate to. Results appear in bounded blocks.
How to use it
- Use New Project Agent or create an agent file.
- Define its name, description and allowed tools.
- Select it from
/or let a Session delegate when appropriate. - Review the result in the Session.
Settings and files
Files use .github/agents/<name>.agent.md with YAML frontmatter for tools, Skills, MCP servers and invocation flags.
Limits
Delegation is sequential and keeps the parent’s model and permission ceiling. A specialist is not an isolated sandbox.