creating-agents

Create a subagent by defining its purpose, selecting tools and a model, writing a system prompt, and saving the agent file to `.claude/agents/` with YAML frontmatter containing name, description, tools, model, permissionMode, and skills. This delegates tasks and coordinates workflows with domain-specific behavior.

System prompts should be concise and task-focused. Frontmatter uses structured YAML with required fields: name, description, tools, model, permissionMode, and skills. This configuration ensures the agent operates consistently and invokes correctly within your workflow.

Yes. Claude Code supports both built-in agents and custom agents. Custom agents are saved under `.claude/agents/` with standardized templates and file formats, allowing you to define purpose, tools, and behavior for project- or user-level task delegation.

Store agent files in `.claude/agents/` with consistent naming and YAML frontmatter. This standardized location and format ensures agents are discoverable, maintainable, and properly configured for task delegation across your project.

Subagents accept configurable tool and model selections defined in the frontmatter. Choose tools and a model based on the agent's purpose. The Core Task Description specifies functional and technical requirements; consult documentation for available model and tool options.

Proactive invocation guidance is part of the agent design process. Once saved under `.claude/agents/` with proper frontmatter, the agent can be invoked according to the patterns and permissions defined in permissionMode and the system prompt.