subagent-creator

Create Claude Code sub-agents with YAML frontmatter and system prompts.

Updated Jan 2, 2026
One-click install
npx skills add https://github.com/stravinest/house-hold-account --skill subagent-creator-stravinest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-creator
Source: https://github.com/stravinest/house-hold-account/tree/main/.claude/skills/subagent-creator
Command: npx skills add https://github.com/stravinest/house-hold-account --skill subagent-creator-stravinest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables rapid creation of specialized Claude Code sub-agents with tailored system prompts and tool configurations, eliminating manual setup for each new automation workflow.

Core Features & Use Cases

  • Structured sub-agent templates: Generates sub-agent files with YAML frontmatter (name, description, tools, model, permissionMode, skills) stored under .claude/agents/ or ~/.claude/agents/.
  • System prompt templates: Provides ready-to-use system prompts and responsibilities that define the sub-agent's role and behavior.
  • Guided creation workflow: Walks users through requirements gathering, scope selection (project vs user), configuration, and file creation.

Quick Start

Copy the provided assets/subagent-template.md to a new file under .claude/agents/ (for example .claude/agents/my-subagent.md) and customize the YAML frontmatter fields to define name, description, and tooling. Then write the system prompt content to describe the sub-agent's behavior.

Frequently Asked Questions about subagent-creator

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 coding task?

To create a Claude Code subagent, you define a Markdown file with YAML frontmatter specifying name, description, tools, model, permissionMode, and skills, then save it under .claude/agents/ or ~/.claude/agents/ for activation.

What is a Claude Code subagent and when do I need custom system prompts?

A Claude Code subagent is a specialized AI assistant configured with custom system prompts and tool permissions for task-specific workflows. You need custom system prompts when automating specialized coding, debugging, or data tasks across projects.

Can I configure specific tools and permissions for Claude Code subagents?

Yes, you configure specific tools and permissions for Claude Code subagents by defining the tools and permissionMode fields within the YAML frontmatter of the agent's Markdown file.

What is the best way to set up task-specific AI workflows for automated delegation?

The best way to set up task-specific AI workflows is using a structured template with YAML frontmatter to define roles and behaviors, storing the configuration as Markdown files in the .claude/agents/ directory for automatic loading.

Does a Claude Code subagent support project-level and user-level scopes?

Yes, Claude Code subagents support both project-level and user-level scopes by storing the Markdown files in either the project directory .claude/agents/ or the user directory ~/.claude/agents/.

Why are my custom Claude Code agents not loading when I start a project?

Custom Claude Code agents may not load if the Markdown file lacks proper YAML frontmatter fields like name, description, and tools, or if the file is not stored in the correct .claude/agents/ directory path.