Browse documentation

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

  1. Use New Project Agent or create an agent file.
  2. Define its name, description and allowed tools.
  3. Select it from / or let a Session delegate when appropriate.
  4. 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.

Related