Initial commit

skills/sub-agent-creator/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: sub-agent-creator
+description: Use PROACTIVELY when creating specialized Claude Code sub-agents for task delegation. Automates agent creation following Anthropic's official patterns with proper frontmatter, tool configuration, and system prompts. Generates domain-specific agents, proactive auto-triggering agents, and security-sensitive agents with limited tools. Not for modifying existing agents or general prompt engineering.
+---
+
+# Sub-Agent Creator
+
+Automates creation of Claude Code sub-agents with proper configuration and proactive behavior.
+
+## When to Use
+
+**Trigger Phrases**:
+- "create a sub-agent for [purpose]"
+- "generate a new sub-agent"
+- "set up a sub-agent to handle [task]"
+- "make a proactive agent that [behavior]"
+
+**Use Cases**:
+- Domain-specific agents (code reviewer, debugger)
+- Proactive agents that auto-trigger on patterns
+- Security-sensitive agents with limited tools
+- Team-shared project-level agents
+
+## Workflow
+
+### Phase 1: Information Gathering
+1. **Purpose**: What task/domain should agent specialize in?
+2. **Name**: Auto-generate kebab-case from purpose
+3. **Description**: Template: "Use PROACTIVELY to [action] when [condition]"
+4. **Location**: Project (.claude/agents/) or User (~/.claude/agents/)
+
+### Phase 2: Technical Configuration
+1. **Model**: inherit (default), sonnet, opus, haiku
+2. **Tools**: Read-only, Code ops, Execution, All, Custom
+3. **System Prompt**: Role, approach, priorities, constraints
+
+### Phase 3: File Generation
+- Build YAML frontmatter
+- Structure system prompt with templates
+- Write to correct location
+
+### Phase 4: Validation & Testing
+- Validate YAML, tools, model
+- Generate testing guidance
+- List customization points
+
+## Frontmatter Structure
+
+```yaml
+---
+name: agent-name
+description: Use PROACTIVELY to [action] when [condition]
+tools: Read, Grep, Glob  # Omit for all tools
+model: sonnet             # Omit to inherit
+---
+```
+
+## Model Options
+
+| Model | Use Case |
+|-------|----------|
+| inherit | Same as main conversation (default) |
+| sonnet | Balanced performance |
+| opus | Maximum capability |
+| haiku | Fast/economical |
+
+## Tool Access Patterns
+
+| Pattern | Tools | Use Case |
+|---------|-------|----------|
+| Read-only | Read, Grep, Glob | Safe analysis |
+| Code ops | Read, Edit, Write | Modifications |
+| Execution | Bash | Running commands |
+| All | * | Full access (cautious) |
+
+## Installation Locations
+
+| Location | Path | Use Case |
+|----------|------|----------|
+| Project | .claude/agents/ | Team-shared, versioned |
+| User | ~/.claude/agents/ | Personal, all projects |
+
+## Success Criteria
+
+- [ ] Valid YAML frontmatter
+- [ ] Agent file in correct location
+- [ ] Description includes "PROACTIVELY"
+- [ ] System prompt has role, approach, constraints
+- [ ] Appropriate tool restrictions
+- [ ] Clear testing instructions
+
+## Security Best Practices
+
+- Default to minimal tool access
+- Require confirmation for "all tools"
+- Validate tool list against available tools
+- Warn about overly broad permissions
+
+## Reference Materials
+
+- `data/models.yaml` - Model options
+- `data/tools.yaml` - Available tools
+- `templates/agent-template.md` - Prompt structure
+- `examples/` - Sample agents (code-reviewer, debugger)
+
+## Testing Your Agent
+
+### Manual Invocation
+```
+Use the [agent-name] sub-agent to [task]
+```
+
+### Proactive Trigger
+Perform action matching the description to test auto-delegation.
+
+### Debugging
+```bash
+# Check file
+cat .claude/agents/[agent-name].md | head -10
+
+# Verify location
+ls .claude/agents/
+```
+
+---
+
+**Version**: 0.1.0 | **Author**: Connor
+
+**Docs**: https://docs.claude.com/en/docs/claude-code/sub-agents