// YAML frontmatter schemas for Claude Code agents and commands. Use when creating or validating agent/command files.
Manages agentdev debug mode — records tool, skill, hook, and agent events to JSONL. Use when debugging agent behavior, optimizing workflows, or analyzing session performance.
Common agent patterns and templates for Claude Code. Use when implementing agents to follow proven patterns for Tasks integration, quality checks, and external model invocation via claudish CLI.
XML tag structure patterns for Claude Code agents and commands. Use when designing or implementing agents to ensure proper XML structure following Anthropic best practices.
YAML format for Claude Code agent definitions as alternative to markdown. Use when creating agents with YAML, converting markdown agents to YAML, or validating YAML agent schemas.
Reference for the 18 Browser Use MCP tools — parameters, return formats, session lifecycle. Use when invoking browser-use MCP tools, navigating, clicking, typing, or extracting page content.
Visual UI debugging — screenshot capture and analysis, responsive layout checking at multiple viewport sizes, CSS validation via DOM state, visual regression detection, before/after state comparison.
| name | schemas |
| description | YAML frontmatter schemas for Claude Code agents and commands. Use when creating or validating agent/command files. |
| disable-model-invocation | true |
| user-invocable | false |
plugin: agentdev updated: 2026-01-20
---
name: agent-name # Required: lowercase-with-hyphens
description: | # Required: detailed with examples
Use this agent when [scenario]. Examples:
(1) "Task description" - launches agent for X
(2) "Task description" - launches agent for Y
(3) "Task description" - launches agent for Z
model: sonnet # Required: sonnet | opus | haiku
color: purple # Optional: purple | cyan | green | orange | blue | red
tools: TaskCreate, TaskUpdate, TaskList, TaskGet, Read, Write # Required: comma-separated, space after comma
skills: skill1, skill2 # Optional: referenced skills
---
| Field | Required | Values | Description |
|---|---|---|---|
name | Yes | lowercase-with-hyphens | Agent identifier |
description | Yes | Multi-line string | 3-5 usage examples |
model | Yes | sonnet, opus, haiku | AI model to use |
color | No | See colors below | Terminal color |
tools | Yes | Tool list | Available tools |
skills | No | Skill list | Referenced skills |
| Color | Agent Type | Examples |
|---|---|---|
purple | Planning | architect, api-architect |
green | Implementation | developer, ui-developer |
cyan | Review | reviewer, designer |
orange | Testing | test-architect, tester |
blue | Utility | cleaner, api-analyst |
red | Critical/Security | (rarely used) |
Orchestrators (Commands):
Task, TaskCreate, TaskUpdate, TaskList, TaskGet, Read, BashAskUserQuestion, Glob, GrepWrite, EditPlanners:
TaskCreate, TaskUpdate, TaskList, TaskGet, Read, Write (for docs)Glob, Grep, BashImplementers:
TaskCreate, TaskUpdate, TaskList, TaskGet, Read, Write, EditBash, Glob, GrepReviewers:
TaskCreate, TaskUpdate, TaskList, TaskGet, ReadGlob, Grep, BashWrite, Edit---
description: | # Required: workflow description
Full description of what this command does.
Workflow: PHASE 1 → PHASE 2 → PHASE 3
allowed-tools: Task, Bash # Required: comma-separated
skills: skill1, skill2 # Optional: referenced skills
---
| Field | Required | Values | Description |
|---|---|---|---|
description | Yes | Multi-line | Command purpose and workflow |
allowed-tools | Yes | Tool list | Tools command can use |
skills | No | Skill list | Referenced skills |
--- presentname is lowercase-with-hyphensdescription includes 3+ examplesmodel is valid (sonnet/opus/haiku)tools is comma-separated with spaces--- present--- presentdescription explains workflowallowed-tools includes Task, TaskCreate, TaskUpdate, TaskList, TaskGet for orchestrators--- present# WRONG - missing colon
name agent-name
# CORRECT
name: agent-name
# WRONG - no spaces after commas
tools: TaskCreate, TaskUpdate, TaskList, TaskGet,Read,Write
# CORRECT
tools: TaskCreate, TaskUpdate, TaskList, TaskGet, Read, Write
# WRONG - too generic
description: Use this agent for development tasks.
# CORRECT
description: |
Use this agent when implementing TypeScript features. Examples:
(1) "Create a user service" - implements service with full CRUD
(2) "Add validation" - adds Zod schemas to endpoints
(3) "Fix type errors" - resolves TypeScript compilation issues