skills.rest
jordanfbrown
jordanfbrownCOMMUNITY
Explore all skills by this author →
GitHub

creating-subagents

Create Claude Code subagents from YAML frontmatter files.

Updated Aug 23, 2026
Search Tags:#automation#subagents#agents#prompts#claude-code#yaml-frontmatter
One-click install
npx skills add https://github.com/jordanfbrown/dotfiles --skill creating-subagents-jordanfbrown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: creating-subagents
Source: https://github.com/jordanfbrown/dotfiles/tree/main/claude/dot-claude/skills/creating-subagents
Command: npx skills add https://github.com/jordanfbrown/dotfiles --skill creating-subagents-jordanfbrown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create specialized Claude Code subagents to handle dedicated tasks by standardizing file structures, prompts, and tooling configurations for rapid agent creation and customization.

Core Features & Use Cases

  • Automates the definition and deployment of new subagents using YAML frontmatter and a system prompt
  • Supports project-wide (.claude/agents) and user-level (~/.claude/agents) agent catalogs
  • Use case: generate a subagent tailored to a specific workflow and load it via the /agents interface

Quick Start

Create a new agent file under .claude/agents (or ~/.claude/agents) with valid YAML frontmatter and a system prompt, then load it with /agents.

Frequently Asked Questions about creating-subagents

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

FAQPage Schema
How do I create a Claude Code subagent for a specific task?▼

You create a Claude Code subagent by defining a YAML frontmatter file with required name and description fields, optional tools and model selections, and a system prompt in the body. Place it in .claude/agents or ~/.claude/agents to standardize agent deployment.

What is YAML frontmatter and how is it used for Claude Code agents?▼

YAML frontmatter is a metadata block at the top of agent files used to configure Claude Code subagents. It ensures required fields like name and description exist, supports optional tools and model selections, and pairs with a system prompt in the file body.

Can I configure specific tools and models for individual Claude Code subagents?▼

Yes, you can configure specific tools and models for individual Claude Code subagents. When defining an agent from a YAML frontmatter file, the setup supports optional tool selections and model choices to tailor the subagent for designated tasks.

Where should subagent files be stored for project-wide versus user-level access?▼

Subagent files should be stored in the .claude/agents directory for project-wide access, or in the ~/.claude/agents directory for user-level access. Both locations function as agent catalogs and can be loaded via the /agents interface.

What's the best way to customize a subagent for a dedicated workflow?▼

The best way to customize a subagent for a dedicated workflow is to define its behavior in a YAML frontmatter file. You specify the name and description, assign designated tools and model selections, and write the tailored system prompt in the file body.

Do I need the /agents interface to load a newly created subagent?▼

Yes, after creating and configuring a subagent file in the correct project or user directory, you load it via the /agents interface. This interface reads the YAML frontmatter and system prompt to deploy the subagent on demand.

Related Skills

Explore More Software Engineering Skills→
ClubMediterraneeClubMediterranee
4

agent-creator

Generate Claude Code agent configurations from user requirements.

Official
Advanced
adiytharpansaadiytharpansa

ai-agent-helper

Optimize AI agent prompts, task decomposition, and tool selection workflows.

Community
Intermediate
benmaierbenmaier

Create data science agents

Design and validate data-science agent prompts and parallel-agent configurations.

Community
Advanced
fcakyonfcakyon
1.0k

agent-development

Convert user requests into validated Markdown agent files with YAML frontmatter.

Community
Basic