Skip to content

Claude Code Agents Documentation

Welcome to the Claude Code Agents documentation section. This comprehensive guide provides detailed user manuals and system prompts for all available Claude Code agents.

What are Claude Code Agents?

Claude Code agents are specialized AI assistants designed to handle specific domains and tasks within the Claude Code ecosystem. Each agent has:

  • Specialized expertise in a particular domain
  • Defined tool access for performing operations
  • Clear boundaries and collaboration patterns
  • Technical specifications for integration

Available Agents

Technical Implementation Agents

Claude Agent Builder

Technical specialist in Claude Code agent implementation, file format validation, and agent ecosystem integration. Use for creating properly formatted agent files, validating YAML frontmatter, and ensuring ecosystem compatibility.

How to Use This Documentation

Each agent page includes:

  1. User Manual: Comprehensive guide for developers
  2. When to use the agent
  3. Effective prompting strategies
  4. Common patterns and templates
  5. Troubleshooting guide

  6. Best practices

  7. System Prompt: Complete agent specification

  8. YAML frontmatter configuration
  9. Core expertise areas
  10. Integration patterns
  11. Quality standards

Agent Selection Guide

Choose the right agent for your task:

Task Type Recommended Agent
Creating new agent files claude-agent-builder
Validating agent compliance claude-agent-builder
Fixing agent integration issues claude-agent-builder

Contributing

To add documentation for a new agent:

  1. Create a new markdown file in /docs/agents/
  2. Include both user manual and system prompt
  3. Update this index page with the new agent
  4. Add the agent to mkdocs.yml navigation

Best Practices for Agent Usage

1. Understand Agent Boundaries

Each agent has specific expertise. Use the right agent for the right task to get optimal results.

2. Follow Sequential Workflows

Many agents work best in combination. For example: - Design with agent-design-architect - Implement with claude-agent-builder - Validate with both agents

3. Use Clear, Specific Prompts

Provide concrete requirements and context to help agents deliver precise results.

4. Leverage Templates and Patterns

Most agents provide templates and patterns. Use these as starting points for consistency and quality.

5. Validate Early and Often

Run validation checks throughout your workflow to catch issues early.

Quick Reference

Common Agent Patterns

  • Technical Specialist: Core development, testing, operations
  • Content Specialist: Documentation, writing, content strategy
  • Coordination Specialist: Workflow orchestration, project management
  • Analysis Specialist: Investigation, monitoring, reporting

Tool Categories

  • File Operations: Glob, Grep, LS, Read, Edit, MultiEdit, Write
  • Workflow: Task, TodoWrite
  • Web: WebFetch, WebSearch
  • Development: Bash, BashOutput, KillBash
  • Specialized: NotebookEdit, ListMcpResourcesTool, ReadMcpResourceTool

Support and Feedback

For questions, issues, or suggestions about agent documentation: - Create an issue in the GitHub repository - Refer to the troubleshooting sections in individual agent manuals - Review best practices and common patterns