skills.rest
richfrem
richfremCOMMUNITY
Explore all skills by this author →
GitHub

create-sub-agent

Design and scaffold Claude Code sub-agent files through a structured interview workflow.

5|3|Updated Feb 21, 2026
Search Tags:#workflow#validation#scaffold#claude-code#sub-agent#agent-file#design-interview
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill create-sub-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-sub-agent
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/agent-scaffolders/skills/create-sub-agent
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill create-sub-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill enables design and scaffolding of Claude Code sub-agents by guiding you through a structured interview workflow and producing a ready-to-use agent file.

Core Features & Use Cases

  • Guided design interview to extract purpose, input/output contract, escalation posture, tools, permissions, model, maxTokens, color, and lifecycle hooks.
  • Generates the agent.md file with complete YAML frontmatter and a system prompt targeting 500-3,000 characters.
  • Validates the generated agent with validate_agent.py and reports the created agent path and next steps.
  • Provides clear placement and deployment guidance for plugin-scoped agents.

Quick Start

Provide an optional agent name or use-case description to start the design interview and generate the agent.md file.

Frequently Asked Questions about create-sub-agent

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

FAQPage Schema
How do I create a Claude Code sub-agent file?▼

You can scaffold a Claude Code sub-agent file by completing a structured design interview that captures intent, inputs, outputs, and permissions, then generates a validated agent.md file with YAML frontmatter.

What is a Claude Code sub-agent design interview?▼

A sub-agent design interview is a guided workflow that extracts purpose, escalation posture, tools, model constraints, and lifecycle hooks to produce a complete agent file configuration.

How do I validate a generated Claude Code agent file?▼

You validate a generated Claude Code agent file by running validation scripts within the scaffolding workflow, which checks structure, reports the created agent path, and guides next steps.

Can I define model constraints and permissions for Claude Code sub-agents?▼

Yes, the design interview workflow captures model constraints, permissions, maxTokens, color, and lifecycle hooks to configure Claude Code sub-agents during the scaffolding process.

What is the best way to scaffold a plugin-scoped Claude Code agent?▼

The best way to scaffold a plugin-scoped Claude Code agent is using a structured design interview that enforces placement rules, generates the file, and provides clear deployment guidance.

Do I need to manually format YAML frontmatter for Claude Code sub-agents?▼

No, manual YAML frontmatter formatting is unnecessary because the scaffolding workflow automatically generates complete frontmatter alongside a system prompt targeting 500-3,000 characters.

Related Skills

Explore More Software Engineering Skills→
galekagaleka
14

create-agent

Guide a structured interview to define custom agent purpose, capabilities, triggers, and output format.

Community
Advanced
blueif16blueif16

{{SKILL_NAME}}

Scaffold Claude plugin structures with YAML frontmatter and documentation templates.

Community
Advanced
wellnessbrotherjay-debugwellnessbrotherjay-debug

Plugin Structure

Scaffold Claude Code plugins with manifest rules and kebab-case naming.

Community
Advanced
LusciiLuscii

make-agent

Generate GitHub Copilot custom agent files with YAML frontmatter and templates.

Official
Basic