subagents-creator
Guide for defining and using Claude subagents effectively. Use when (1) creating new subagent types, (2) learning how to delegate work to specialized subagents, (3) improving subagent delegation prompts, (4) understanding subagent orchestration patterns, or (5) debugging ineffective subagent usage.
Best use case
subagents-creator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Guide for defining and using Claude subagents effectively. Use when (1) creating new subagent types, (2) learning how to delegate work to specialized subagents, (3) improving subagent delegation prompts, (4) understanding subagent orchestration patterns, or (5) debugging ineffective subagent usage.
Teams using subagents-creator should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/subagents-creator/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How subagents-creator Compares
| Feature / Agent | subagents-creator | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Guide for defining and using Claude subagents effectively. Use when (1) creating new subagent types, (2) learning how to delegate work to specialized subagents, (3) improving subagent delegation prompts, (4) understanding subagent orchestration patterns, or (5) debugging ineffective subagent usage.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# Subagents Creator
This skill provides guidance for defining, using, and improving Claude subagents—the specialized agents that handle specific domains like `explore`, `librarian`, `oracle`, and `frontend-ui-ux-engineer`.
## Quick Start
### Delegating Work
When delegating to subagents, use the **mandatory 7-section structure**:
```
1. TASK: Atomic, specific goal (one action per delegation)
2. EXPECTED OUTCOME: Concrete deliverables with success criteria
3. REQUIRED SKILLS: Which skill to invoke
4. REQUIRED TOOLS: Explicit tool whitelist (prevents tool sprawl)
5. MUST DO: Exhaustive requirements - leave NOTHING implicit
6. MUST NOT DO: Forbidden actions - anticipate and block rogue behavior
7. CONTEXT: File paths, existing patterns, constraints
```
### Choosing a Subagent
See [subagent-types.md](references/subagent-types.md) for detailed guidance on which subagent to use:
- **`explore`**: Contextual grep for codebases
- **`librarian`**: Reference search (docs, OSS, web)
- **`oracle`**: Deep reasoning for architecture/complex decisions
- **`frontend-ui-ux-engineer`**: Visual UI/UX changes
## Defining New Subagents
**Only create subagents when**: The task domain has distinct tooling, expertise, or patterns that benefit from specialization.
See [delegation-patterns.md](references/delegation-patterns.md) for:
- Subagent definition templates
- When to create a new subagent vs using existing ones
- Naming and description guidelines
## Common Pitfalls
See [common-pitfalls.md](references/common-pitfalls.md) for:
- Vague delegation prompts and why they fail
- Over-delegating trivial tasks
- Subagent misalignment with task type
- Anti-patterns in agent orchestration
## Best Practices
1. **One action per delegation**: Combine tasks in parallel calls, not one call
2. **Be exhaustive**: "MUST DO" and "MUST NOT DO" sections prevent drift
3. **Background everything**: Use `background_task` for `explore` and `librarian`
4. **Explicit tool lists**: Prevent subagents from using unauthorized tools
5. **Verify results**: Check that delegated work meets expectations before proceeding
## Delegation Example
```python
# GOOD: Specific, exhaustive
background_task(
agent="explore",
prompt="""
1. TASK: Find all authentication implementations
2. EXPECTED OUTCOME: List of files with auth logic, patterns used
3. REQUIRED SKILLS: explore
4. REQUIRED TOOLS: Grep, Read
5. MUST DO: Search for 'jwt', 'session', 'auth' patterns; identify middleware; list all endpoints
6. MUST NOT DO: Don't modify any files; don't run build/test commands
7. CONTEXT: Working in ./src directory, looking for Express.js patterns
"""
)
# BAD: Vague, implicit expectations
background_task(
agent="explore",
prompt="Find auth stuff in the codebase"
)
```
## Reference Files
- [subagent-types.md](references/subagent-types.md) - When to use each subagent type
- [delegation-patterns.md](references/delegation-patterns.md) - Prompt templates and patterns
- [common-pitfalls.md](references/common-pitfalls.md) - Anti-patterns and how to avoid themRelated Skills
Suno Song Creator
This skill should be used when the user asks to "create a Suno prompt", "write a Suno song", "generate music with Suno", "help me with Suno", "make a song prompt", "create lyrics for Suno", "build a music prompt", or mentions Suno AI music generation. Provides comprehensive guidance for creating professional Suno prompts using advanced prompting strategies, structured formatting within 1000 character limit (NO blank lines between sections), parameter optimization, genre-specific techniques, interactive questioning with efficient project name collection, automated artist/song research via sub-agent (web fetching + pattern extraction), automatic file export to organized project directories, AI-slop avoidance for authentic human-centered lyrics, copyright-safe style descriptions that avoid artist/album/song names, character counting utilities for accurate verification, and optional independent quality review via sub-agent for professional assessment.
Subagents Guide
Specialized AI assistants for task-specific workflows with separate context. Learn when to delegate, configure tools, and apply best practices.
skill-creator
Specialized skill for creating new OpenCode agent skills. Detailed instructions on triggers, structure, and best practices. Triggers: 'create a skill', 'make a new skill', 'add a skill', 'new skill'.
skill-creator-ms
Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
power-agent-creator
This skill should be used when users want to create powerful AI agents comparable to Claude Code or sonph-code. It provides battle-tested system prompts, masterfully-crafted tool implementations, and the simple but powerful agent loop pattern. Use this skill when users ask to build coding agents, AI assistants with tools, or any autonomous agent that needs file operations, code execution, search, and task management capabilities. The key insight is that customization requires only ONE HumanMessage after the SystemPrompt.
metric-creator
Create new Fair-Forge metrics with proper structure, schema, tests, and fixtures. Use when adding a new evaluation metric to fair-forge.
custom-agent-creator
Skill to create custom agents for VS Code Copilot or OpenCode, helping users configure and generate agent files with proper formatting and configurations. Use when users want to create specialized AI assistants for VS Code Copilot (.agent.md files) or OpenCode (JSON/markdown agent configs) with specific tools, prompts, models, and behaviors. If the user is not specific about the target platform, ask them to specify Copilot or OpenCode.
agent-creator
This skill should be used when the user asks to "create a new agent", "make a subagent", "build an agent for X", "generate agent configuration", or wants to create a new Claude Code sub-agent. Triggers on "agent-creator", "new agent", "subagent", or agent creation requests.
voice-dna-creator
Analyze writing samples to create a comprehensive voice DNA profile. Use when the user wants to capture their unique writing voice, needs to create a voice profile for AI content, or is setting up a new writing system.
redbook-creator
Use this skill when the user wants to create Xiaohongshu (小红书/RedBook) posts. Trigger phrases: 小红书创作, create redbook, 小红书, 红书, 笔记创作, 帖子创作. The user will provide images, videos, or text content. This skill analyzes the content, searches for trending Xiaohongshu posts as reference, generates post title and copy, auto-edits videos (merge, subtitles, BGM, narration), attempts auto-upload to Xiaohongshu creator platform, and generates a local preview HTML file.
medium-posts-creator
Transform arbitrary text into well-structured Medium article drafts following a four-part structure: three variations of article title, Benefits from solution, Problem description, and Solution itself. Use when user requests: creating a Medium article from text, writing a blog post about a topic, transforming content into a Medium draft, or any request to transform text into a publishable article format. Includes Medium formatting guidelines, optional writing style suggestions, and enhancement tips for SEO, CTAs, and engagement.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.