agent-creator

Create and optimize Claude Code subagent files with YAML frontmatter.

Updated Jan 18, 2026

Search Tags:#automation #subagents #claude-code #frontmatter #yaml-frontmatter #agent-files #md-template

Ready to run

npx skills add https://github.com/rom-orlovich/agents-system --skill agent-creator-rom-orlovich

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-creator
Source: https://github.com/rom-orlovich/agents-system/tree/main/.claude/skills/agent-creator
Command: npx skills add https://github.com/rom-orlovich/agents-system --skill agent-creator-rom-orlovich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you create and optimize Claude Code subagent files (.claude/agents/*.md) per official best practices, streamlining the process of defining subagents, setting YAML frontmatter, and organizing agent files.

Core Features & Use Cases

Create new subagent Markdown files with proper frontmatter (name, description, tools, model, etc.).
Validate and structure agent files to align with project conventions and loading rules.
Provide ready-to-use templates and examples for various subagents.

Quick Start

Use the agent-creator skill to generate a new subagent file named my-agent.md with correct frontmatter and a concise system prompt.

Frequently Asked Questions about agent-creator

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

FAQPage Schema

How do I create Claude Code subagent files with proper YAML frontmatter?▼

To create Claude Code subagent files, you generate Markdown files in the .claude/agents/ directory with YAML frontmatter containing required fields like name and description. Optional fields include tools, model, permissions, and hooks for extended functionality.

What is the required frontmatter structure for a Claude Code subagent?▼

A Claude Code subagent requires name and description fields in its YAML frontmatter. Optional fields including tools, model, permissions, and hooks are supported to further customize agent behavior and execution.

How do I organize agent files across local and version-controlled locations?▼

You organize agent files by placing .md templates in local or version-controlled .claude/agents/ directories according to project loading rules. This structure ensures subagents load correctly while aligning with established project conventions.

What is the best way to structure a subagent system prompt in an md template?▼

Structuring a subagent system prompt in an md template requires a concise prompt body alongside properly formatted YAML frontmatter. Using ready-made templates ensures the agent file aligns with official best practices and project conventions.

Can I use optional fields like tools and hooks in Claude Code agent files?▼

Yes, Claude Code agent files support optional frontmatter fields including tools, model, permissions, and hooks. These fields allow you to customize the subagent's available resources and execution behavior beyond the required name and description.