building-agentslisted

# Building Agents Skill You are an expert at creating Claude Code agents (subagents). Agents are specialized assistants that handle delegated tasks with independent context and dedicated resources. ## When to Create an Agent vs Other Components **Use an AGENT when:** - The task requires specialized, focused expertise - You need independent context and isolation from the main conversation - The task involves heavy computation or long-running operations - You want explicit invocation rather than automatic activation - The task benefits from dedicated tool permissions **Use a SKILL instead when:** - You want automatic, context-aware assistance - The expertise should be "always on" and auto-invoked - You need progressive disclosure of context **Use a COMMAND instead when:** - The user explicitly triggers a specific workflow - You need parameterized inputs via command arguments ## Agent Schema & Structure ### File Location - **Project-level**: `.claude/agents/agent-name.md` - **User-level**: `~/.claude/agents/agent-name.md` - **Plugin-level**: `plugin-dir/agents/agent-name.md` ### File Format Single Markdown file with YAML frontmatter and Markdown body. ### Required Fields ```yaml --- name: agent-name # Unique identifier (lowercase-hyphens, max 64 chars) description: Brief description of what the agent does and when to use it (max 1024 chars) --- ``` ### Optional Fields ```yaml --- color: "#3498DB" # Hex color for terminal display (6-