[DOCS] Add color field to sub-agents supported frontmatter fields

Resolved 💬 7 comments Opened Jan 19, 2026 by SerhiiFesenko Closed Mar 3, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/sub-agents#supported-frontmatter-fields

Section/Topic

Sub-agents - Supported frontmatter fields table

Current Documentation

The "Supported frontmatter fields" table lists: name, description, tools, disallowedTools, model, permissionMode, skills, hooks.

The color field is not mentioned.

What's Wrong or Missing?

The color field is undocumented in the supported frontmatter fields table, but:

  1. The Quickstart guide Step 6 mentions "Choose a color"
  2. The official plugin-dev agent-development skill

treats color as required

When creating agents manually, users cannot know:

  • That the color field exists
  • Whether it's required or optional
  • What values are supported (blue, cyan, green, yellow, magenta, red)

Suggested Improvement

Add color to the supported frontmatter fields table:

| Field | Required | Description |
|-------|----------|-------------|
| color | Yes | Background color for the agent in UI. Values: blue, cyan, green, yellow, magenta, red |

Also consider adding semantic usage guidance:

  • blue/cyan - Analysis, review
  • green - Success-oriented tasks
  • yellow - Caution, validation
  • red - Critical, security
  • magenta - Creative, generation

Impact

High - Prevents users from using a feature

Additional Context

_No response_

View original on GitHub ↗

This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗