sub-agent-creator

Create Claude Code sub-agents with frontmatter, tool configuration, and system prompts.

7|3|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/cskiro/annex --skill sub-agent-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sub-agent-creator
Source: https://github.com/cskiro/annex/tree/main/skills/sub-agent-creator
Command: npx skills add https://github.com/cskiro/annex --skill sub-agent-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through producing production-ready Claude Code sub-agents that conform to Anthropic's patterns, including YAML frontmatter, tool configuration, and system prompts. It streamlines creating domain-specific agents (e.g., code-reviewer, debugger) and personal or team-level agents with secure defaults.

Core Features & Use Cases

  • Frontmatter generation: ensures required fields (name, description)
  • Tool configuration: security-conscious defaults and explicit permission settings
  • Model selection: supports inherit, sonnet, opus, haiku
  • System prompt scaffolding: defines role, approach, constraints
  • Validation guidance: tests and best-practices for agent quality

Quick Start

Use this skill to generate a new sub-agent by answering a few prompts; you will get a ready-to-use Markdown file at .claude/agents/<agent-name>.md (project-level) or ~/.claude/agents/ (user-level).

Frequently Asked Questions about sub-agent-creator

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

FAQPage Schema
How do I create a Claude Code sub-agent with proper frontmatter and tool configuration?

Creating a Claude Code sub-agent requires defining YAML frontmatter with required fields (name, description), configuring tools with security-conscious defaults, selecting a model (inherit, sonnet, opus, haiku), and structuring a system prompt that defines role and constraints. This Skill automates that entire process, generating a production-ready Markdown file at `.claude/agents/<agent-name>.md` or `~/.claude/agents/` based on your answers to setup prompts.

What are domain-specific sub-agents and when should I create them?

Domain-specific sub-agents are Claude Code agents tailored for particular tasks—code-reviewer, debugger, data-scientist—or for proactive auto-triggering and security-sensitive workflows. Create them when you need specialized behavior, consistent tool permissions, or dedicated system prompts for repetitive tasks across projects or teams. This Skill generates them at both project and user storage levels.

Can I automate sub-agent creation across multiple projects?

Yes. This Skill supports both project-level storage (`.claude/agents/`) for project-specific agents and user-level storage (`~/.claude/agents/`) for reusable agents across projects. Automation includes frontmatter validation, tool permission setup, and system-prompt structure, so agents conform to Anthropic patterns regardless of storage location.

What validation and testing should I do after generating a sub-agent?

After generation, validate frontmatter syntax, verify tool permissions align with your security requirements, test the system prompt with sample inputs, and confirm the agent behaves as intended in your workflow. This Skill provides validation guidance and best-practices documentation to ensure production-ready quality before deployment.

Do I need to manually write system prompts for each sub-agent?

No. This Skill scaffolds system-prompt structure automatically, defining role, approach, and constraints based on your agent's domain and purpose. You provide the context, and the Skill generates a template you can refine, eliminating boilerplate and ensuring consistency across agents.

What model options are available when creating a sub-agent?

This Skill supports four model-selection options: inherit (uses the parent Claude Code session's model), sonnet, opus, and haiku. Choose based on your agent's task complexity and latency requirements; the Skill applies your selection to the frontmatter and ensures correct configuration.