Spawn - Expert Agent Generator

Generate world-class, comprehensive expert agent prompts for Claude Code. Each agent should be a definitive reference for its domain - the kind of guide a PhD-level practitioner would create.

Target quality: 500-1000 lines per agent with real code examples, complete configs, and detailed patterns.

Benchmark agents: python-expert.md (1600 lines), claude-architect.md (1242 lines), react-expert.md (440 lines)

Usage Modes

Mode 1: Single Agent Generation

Generate one expert agent prompt for a specific technology platform.

Prompt for:

• Technology platform/framework name
• Scope (project-level or global/user-level)
• Focus areas (optional: specific features, patterns, use cases)
• Output format (markdown file or clipboard-ready text)

Mode 2: Batch Agent Generation

Create multiple agent prompts from a list of technology platforms.

Accept:

• Multi-line list of technology platforms
• Scope (project-level or global/user-level)
• Common focus areas (optional)
• Output format (individual .md files or consolidated text)

Mode 3: Architecture Analysis

Analyze a tech stack or architecture description and suggest relevant agents.

Process:

1. Read architecture description (from user input or file)
2. Identify all technology platforms/services
3. Ask for scope (project or global)
4. Present checkbox selector for agent creation
5. Generate selected agents

Agent File Format

All agents MUST be created as Markdown files with YAML frontmatter:

• Project-level: .claude/agents/ (current project only)
• Global/User-level: ~/.claude/agents/ or C:\Users\[username]\.claude\agents\ (all projects)

File Structure:

---
name: technology-name-expert
description: When this agent should be used. Can include examples and use cases. No strict length limit - be clear and specific. Include "use PROACTIVELY" for automatic invocation.
model: inherit
color: blue
---

[Agent system prompt content here]

YAML Frontmatter Fields:

• name (required): Unique identifier, lowercase-with-hyphens (e.g., "asus-router-expert")
• description (required): Clear, specific description of when to use this agent
  • No strict length limit - prioritize clarity over brevity
  • Can include examples, use cases, and context
  • Use "use PROACTIVELY" or "MUST BE USED" to encourage automatic invocation
  • Multi-line YAML string format is fine for lengthy descriptions
• tools (optional): Comma-separated list of allowed tools (e.g., "Read, Grep, Glob, Bash")
  • If omitted, agent inherits all tools from main session
  • Best practice: Only grant tools necessary for the agent's purpose (improves security and focus)
• model (optional): Specify model ("sonnet", "opus", "haiku", or "inherit" to use main session model)
• color (optional): Visual identifier in UI ("blue", "green", "purple", etc.)

File Creation: Agents can be created programmatically using the Write tool:

Project-level: .claude/agents/[platform]-expert.md
Global/User-level: ~/.claude/agents/[platform]-expert.md (or C:\Users\[username]\.claude\agents\ on Windows)

Choosing Scope:

• Project Agent (.claude/agents/): Specific to the current project, can be version controlled and shared with team
• Global Agent (~/.claude/agents/): Available across all projects on your machine

After creation, the agent is immediately available for use with the Task tool.

Claude Code Agent Documentation

Essential Reading:

• Subagents Overview: https://docs.claude.com/en/docs/claude-code/sub-agents
• Subagents in SDK: https://docs.claude.com/en/api/agent-sdk/subagents
• Agent SDK Overview: https://docs.claude.com/en/api/agent-sdk/overview
• Agent Skills Guide: https://docs.claude.com/en/docs/claude-code/skills
• Agent Skills in SDK: https://docs.claude.com/en/api/agent-sdk/skills
• Skill Authoring Best Practices: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices
• Using Agent Skills with API: https://docs.claude.com/en/api/skills-guide
• Agent Skills Quickstart: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/quickstart
• Claude Code Settings: https://docs.claude.com/en/docs/claude-code/settings
• Common Workflows: https://docs.claude.com/en/docs/claude-code/common-workflows
• Claude Code Overview: https://docs.claude.com/en/docs/claude-code/overview
• Plugins Reference: https://docs.claude.com/en/docs/claude-code/plugins-reference

Key Concepts from Documentation:

• Subagents operate in separate context windows with customized system prompts
• Each subagent can have restricted tool access for focused capabilities
• Multiple subagents can run concurrently for parallel processing
• User-level agents (~/.claude/agents/) are available across all projects
• Project-level agents (.claude/agents/) are project-specific and shareable
• Use /agents command for the recomm

...