subagent-creator

Creates and configures Claude Code subagent .md files for project and user levels.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/hungson175/shared-claude-config --skill subagent-creator-hungson175
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subagent-creator
Source: https://github.com/hungson175/shared-claude-config/tree/main/skills/subagent-creator
Command: npx skills add https://github.com/hungson175/shared-claude-config --skill subagent-creator-hungson175

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The subagent-creator skill simplifies the process of defining and provisioning Claude Code subagents by generating ready-to-use .md configuration files at project and user levels, with clear prompts, tools, and model settings.

Core Features & Use Cases

  • Create project-level agents under .claude/agents/ and user-level agents under ~/.claude/agents/.
  • Define subagent attributes such as name, description, tools, model, permissionMode, and skills, plus optional patterns and templates.
  • Provide guided workflows and design-pattern guidance to help users design focused, secure, and effective subagents for coding, debugging, and automation.

Quick Start

Use this skill to generate a new subagent configuration by following the project-level or user-level creation flow:

  • Create a new agent file in the appropriate directory, e.g. .claude/agents/my-agent.md or ~/.claude/agents/my-agent.md.
  • Open the file and update the YAML frontmatter with name, description, and any optional fields.
  • Run Claude's agent creation command (e.g. /agents) to guided through prompts and save the final configuration.

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 custom Claude Code subagent for my project?▼

To create a Claude Code subagent, you generate a markdown configuration file under the .claude/agents/ directory, define its name and description in the YAML frontmatter, and optionally add fields like tools, model, and permissionMode.

What is the difference between project-level and user-level Claude subagents?▼

Project-level Claude subagents are stored in the .claude/agents/ directory for specific workflows, while user-level subagents are saved in ~/.claude/agents/ to be available across all your local projects.

What attributes can I configure when defining a Claude subagent?▼

When defining a Claude subagent, you can configure attributes including name, description, tools, model, permissionMode, and skills, along with optional patterns and templates stored in a references directory.

Do I need a SKILL.md file to set up a Claude subagent?▼

Yes, setting up a Claude subagent requires a SKILL.md file at the root directory containing at minimum the agent's name and description to function properly.

What is the best way to design focused and secure Claude subagents for automation?▼

The best way to design secure Claude subagents is to follow guided workflows and design-pattern guidance that help you configure specific prompts, tools, model settings, and permission modes for coding and automation tasks.

Can I use templates and design patterns to generate Claude subagent configurations?▼

Yes, you can use optional directories like references to support design patterns and templates, enabling you to generate standardized and effective Claude subagent configurations.