Create Agent Skill
Create new Claude Code agents with proper configuration and structure.
Agent File Format
Agents are markdown files in the agents/ directory with YAML frontmatter:
---
name: agent-name
description: Full description of what the agent does and when to use it
tools: Glob, Grep, Read, Write, Edit, Bash, WebFetch, WebSearch, TodoWrite
model: sonnet
color: green
---
# Agent Title
Agent prompt content goes here...
Required Frontmatter Fields
| Field |
Description |
Example |
name |
Unique identifier (kebab-case) |
code-reviewer |
description |
One-line summary of agent's purpose |
Reviews code for quality and best practices |
tools |
Comma-separated list of available tools |
Glob, Grep, Read, Write, Edit, Bash |
model |
Model to use: opus, sonnet, or haiku |
sonnet |
color |
Status line color |
green, blue, purple, red, orange, cyan, magenta, yellow, pink, teal, violet |
Model Selection Guidelines
- opus: Strategic decisions, complex architecture, security-critical, compliance, executive-level analysis
- sonnet: Technical implementation, code writing, general development tasks (most common)
- haiku: Quick lookups, simple transformations, fast responses
Available Tools
Common tool combinations by agent type:
Code Development Agents
Glob, Grep, Read, Write, Edit, Bash, TodoWrite
Research/Analysis Agents
Glob, Grep, Read, WebFetch, WebSearch, TodoWrite
Full-Featured Agents
Glob, Grep, Read, Write, Edit, Bash, WebFetch, WebSearch, TodoWrite
Creation Process
- Determine the agent's purpose and expertise area
- Choose appropriate model based on complexity
- Select tools needed for the agent's tasks
- Write clear, actionable agent prompt
- Save to
plugins/<plugin-name>/agents/<agent-name>.md
Example Agent
---
name: code-reviewer
description: Reviews code changes for quality, security, and best practices. Use when user wants code reviewed, needs security audit, or asks about code quality.
tools: Glob, Grep, Read, TodoWrite
model: sonnet
color: yellow
---
# Code Reviewer Agent
You are an expert code reviewer focused on quality, security, and maintainability.
## Review Checklist
- Code correctness and logic
- Security vulnerabilities
- Performance considerations
- Code style and consistency
- Test coverage
- Documentation
## Output Format
Provide structured feedback with:
1. Summary of changes
2. Issues found (categorized by severity)
3. Recommendations
4. Approval status
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: create-agent-93description: Create a new Claude Code agent with proper YAML frontmatter structure. Use when the user wants to add a specialized agent to a plugin. Handles agent file creation with name, description, tools, model selection, and color configuration. Use when this capability is needed.4---56# Create Agent Skill78Create new Claude Code agents with proper configuration and structure.910## Agent File Format1112Agents are markdown files in the `agents/` directory with YAML frontmatter:1314```markdown15---16name: agent-name17description: Full description of what the agent does and when to use it18tools: Glob, Grep, Read, Write, Edit, Bash, WebFetch, WebSearch, TodoWrite19model: sonnet20color: green21---2223# Agent Title2425Agent prompt content goes here...26```2728## Required Frontmatter Fields2930| Field | Description | Example |31|-------|-------------|---------|32| `name` | Unique identifier (kebab-case) | `code-reviewer` |33| `description` | One-line summary of agent's purpose | `Reviews code for quality and best practices` |34| `tools` | Comma-separated list of available tools | `Glob, Grep, Read, Write, Edit, Bash` |35| `model` | Model to use: `opus`, `sonnet`, or `haiku` | `sonnet` |36| `color` | Status line color | `green`, `blue`, `purple`, `red`, `orange`, `cyan`, `magenta`, `yellow`, `pink`, `teal`, `violet` |3738## Model Selection Guidelines3940- **opus**: Strategic decisions, complex architecture, security-critical, compliance, executive-level analysis41- **sonnet**: Technical implementation, code writing, general development tasks (most common)42- **haiku**: Quick lookups, simple transformations, fast responses4344## Available Tools4546Common tool combinations by agent type:4748### Code Development Agents49```50Glob, Grep, Read, Write, Edit, Bash, TodoWrite51```5253### Research/Analysis Agents54```55Glob, Grep, Read, WebFetch, WebSearch, TodoWrite56```5758### Full-Featured Agents59```60Glob, Grep, Read, Write, Edit, Bash, WebFetch, WebSearch, TodoWrite61```6263## Creation Process64651. Determine the agent's purpose and expertise area662. Choose appropriate model based on complexity673. Select tools needed for the agent's tasks684. Write clear, actionable agent prompt695. Save to `plugins/<plugin-name>/agents/<agent-name>.md`7071## Example Agent7273```markdown74---75name: code-reviewer76description: Reviews code changes for quality, security, and best practices. Use when user wants code reviewed, needs security audit, or asks about code quality.77tools: Glob, Grep, Read, TodoWrite78model: sonnet79color: yellow80---8182# Code Reviewer Agent8384You are an expert code reviewer focused on quality, security, and maintainability.8586## Review Checklist8788- Code correctness and logic89- Security vulnerabilities90- Performance considerations91- Code style and consistency92- Test coverage93- Documentation9495## Output Format9697Provide structured feedback with:981. Summary of changes992. Issues found (categorized by severity)1003. Recommendations1014. Approval status102```103104---105> Converted and distributed by [TomeVault](https://tomevault.io/claim/jpoutrin) — claim your Tome and manage your conversions.106<!-- tomevault:4.0:skill_md:2026-04-11 -->