[DOCS] Add color field to sub-agents supported frontmatter fields
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:
- The Quickstart guide Step 6 mentions "Choose a color"
- The official plugin-dev agent-development skill
treats color as required
When creating agents manually, users cannot know:
- That the
colorfield 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, reviewgreen- Success-oriented tasksyellow- Caution, validationred- Critical, securitymagenta- Creative, generation
Impact
High - Prevents users from using a feature
Additional Context
_No response_
This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗