skills.rest
jpoutrin
jpoutrinCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

create-agent

Create Claude Code agent markdown files with required YAML frontmatter fields.

14|1|Updated Dec 5, 2025
Search Tags:#automation#templates#markdown#agent#agents#frontmatter
One-click install
npx skills add https://github.com/jpoutrin/product-forge --skill create-agent-jpoutrin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-agent
Source: https://github.com/jpoutrin/product-forge/tree/main/plugins/claude-code-dev/skills/create-agent
Command: npx skills add https://github.com/jpoutrin/product-forge --skill create-agent-jpoutrin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users scaffold a new Claude Code agent markdown file with the required YAML frontmatter and example content.

Core Features & Use Cases

  • Define agent file format and required fields (name, description, tools, model, color)
  • Example agent.md with prompts
  • Guidelines for agent prompts and color coding

Quick Start

Create a new file under agents/ (e.g., agents/code-reviewer.md) with the mandated frontmatter.

Frequently Asked Questions about create-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code agent with the proper YAML frontmatter structure?▼

Create a markdown file under `plugins/<plugin-name>/agents/<agent-name>.md` with YAML frontmatter containing required fields: name, description, tools, model, and color. Add your agent prompt below the frontmatter separator. This enforces consistent agent configuration across your project.

What fields are required when setting up a new agent file?▼

Required frontmatter fields are name, description, tools, model, and color. Optional fields include short and when. The frontmatter must appear at the top of the markdown file before your agent prompt content.

Can I define optional fields like 'short' and 'when' in my agent configuration?▼

Yes, the agent scaffold supports optional frontmatter fields short and when alongside the five required fields. These let you add conditional logic and shortened descriptions to your agent definition.

Where should agent files be placed in a Claude Code plugin project?▼

Agent markdown files go in the `plugins/<plugin-name>/agents/` directory. The filename becomes the agent identifier, so use descriptive names like `code-reviewer.md` for clear organization.

Do I need any dependencies or components to create agent files?▼

No external dependencies are required. This Skill generates self-contained agent markdown files with frontmatter and prompts that work standalone in your Claude Code plugin structure.

What's the difference between required and optional agent frontmatter fields?▼

Required fields—name, description, tools, model, color—must be present in every agent. Optional fields like short and when add metadata for conditional execution or display without affecting core agent functionality.

Related Skills

Explore More Software Engineering Skills→
jimloopjimloop

create-plugin

Create Claude Code plugins with valid component structures and configuration patterns.

Community
Intermediate
shawn-sandyshawn-sandy

add-command

Scaffold Claude Code slash command files and append workflow stubs to SKILL.md.

Community
Basic
AreteDriverAreteDriver
4

plugin-builder

Build and package Claude Code plugins with a plugin.json manifest.

Community
Advanced
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate