agent-expert — Claude Code subagent: what it does, how to install
A subagent that helps you design other Claude agents: structure, expertise boundaries, prompts and examples.
npx claude-code-templates@latest --agent expert-advisors/agent-expertWhat agent-expert does
agent-expert is a Claude subagent for building specialized agents. It works through the domain, sets expertise boundaries, drafts a description with examples, and lays it all out as a Markdown file in the claude-code-templates format.
Inside you get templates for several agent types: technical specializations (frameworks, databases, infrastructure), domain experts (security, performance, testing), industry agents, and workflow ones like code review or architecture design. Prompt engineering gets its own treatment: how to describe competency areas, how to write examples with context, and how to state limitations so an agent stays out of someone else's lane.
It earns its place when you maintain a set of agents and want them to stop overlapping. Creation starts with domain analysis. Without a clear idea of what the agent handles and what it doesn't, there's nothing to fill the template with. The source text is truncated, so check the agent file itself for the full list of sections and format requirements.
What it helps with
- write a new Claude agent in Markdown in the right format
- split expertise areas between several agents
- find examples with context for an agent description
- state limitations so an agent stays inside its domain
- pick the right agent type: technical, domain or workflow
Example prompts for the agent
- Help me create an agent for React performance optimization
- Design an agent that covers both frontend and backend security
- Review my agent description and point out where the expertise boundaries blur
How to install agent-expert
1claude-code-templates
npx claude-code-templates@latest --agent expert-advisors/agent-expert2Manually: put the files in place
.claude/agents/agent-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/agent-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/agent-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about agent-expert
How do I install agent-expert in Claude?
Through the templates: npx claude-code-templates@latest --agent expert-advisors/agent-expert. The agent file then lands at .claude/agents/agent-expert.md.
What does agent-expert do?
It helps you create and design specialized Claude agents: domain analysis, structure, examples and limitations, all written into a Markdown file.
How is agent-expert different from a regular agent?
It works on the agents themselves rather than your project code: descriptions, prompts and expertise boundaries. It's for people maintaining an agent set in claude-code-templates.