superhealth/skills-hub/agent-management

Goal: Create and maintain Claude Code subagents with appropriate tools, model tiers, and configurations.

IMPORTANT: Keep subagent content high-level and concise. Do not dive into implementation details.

Workflow

Phase 1: Assessment

• Read .claude/skills/agents-management/references/subagent-doc.md
• Read template at .claude/skills/agents-management/template.md
• Analyze requirements and identify agent role
• Check if agent exists (update vs create)
• Determine model tier based on task complexity

Phase 2: Configuration

• Define persona and core responsibilities
• Select minimal required tool permissions
• Structure workflow phases and constraints
• Follow template structure exactly

Phase 3: Implementation

• Write or update agent configuration file
• Validate YAML frontmatter and sections
• Save it to the appropriate folder in the .claude/agents directory
• Report completion with agent details and location

Constraints

• No unnecessary tool permissions
• No duplicate or conflicting agent roles
• Do not overengineer configurations
• DO NOT deviate from the template structure

Acceptance Criteria

• Agent file created/updated in .claude/agents/[team]/ folder
• YAML frontmatter includes name, description, tools, model, color
• Follows template structure with all required sections
• No conflicts with existing agents in the ecosystem
• Report delivered with location and usage guidance