How do I install the Create Agent skill?

Run npx skillmds add majiayu000/create-agent-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Create Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Create Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Create Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Create Agent?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Create Agent by majiayu000 — Agent Skill

Name: Create Agent
Rating: 4.5 (4 reviews)
Author: majiayu000

Create Agent

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.

majiayu000 130a6dc 2 files · 4.4 KB Updated Sep 9, 2026 567 repo stars

File contents

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
short: Brief 5-8 word description
description: Full description of what the agent does
when: Semantic activation - describe when to use this agent
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`

Optional Frontmatter Fields

Field	Description	Example
`short`	Brief 5-8 word summary for index display	`Reviews code for security and quality`
`when`	Semantic activation trigger for index display	`User wants code reviewed, needs security audit, or asks about code quality`

Note: short and when are used for forge-index display. The description field is used by Claude Code for agent invocation.

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
short: Reviews code for security and quality
description: Reviews code changes for quality, security, and best practices
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

---name: create-agent-3description: 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.--- # 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: ```markdown --- name: agent-name short: Brief 5-8 word description description: Full description of what the agent does when: Semantic activation - describe when to use this agent 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` | ## Optional Frontmatter Fields | Field | Description | Example | |-------|-------------|---------| | `short` | Brief 5-8 word summary for index display | `Reviews code for security and quality` | | `when` | Semantic activation trigger for index display | `User wants code reviewed, needs security audit, or asks about code quality` | **Note**: `short` and `when` are used for forge-index display. The `description` field is used by Claude Code for agent invocation. ## 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 1. Determine the agent's purpose and expertise area 2. Choose appropriate model based on complexity 3. Select tools needed for the agent's tasks 4. Write clear, actionable agent prompt 5. Save to `plugins/<plugin-name>/agents/<agent-name>.md` ## Example Agent ```markdown --- name: code-reviewer short: Reviews code for security and quality description: Reviews code changes for quality, security, and best practices 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 ```

Frequently asked questions