It does not create the skills an agent references -- for that, use skill-creator; agent-creator only wires the agent frontmatter and workflow around skills that already exist or are created alongside it.
Agent Creator
Agent Workflow (MANDATORY)
Before ANY agent creation, delegate via Agent — spawn 2 agents in parallel (single message, 2 Agent calls). Generated agents carry Agent and SendMessage in their tools, so this same pattern is what they must use internally too:
- fuse-ai-pilot:explore-codebase - Check existing agents, analyze patterns
- fuse-ai-pilot:research-expert - Fetch latest agent conventions
mcp__context7__query-docs is a direct MCP call, not a spawned agent — invoke it directly (alongside the 2 Task calls) to get examples from existing agents.
After creation, run fuse-ai-pilot:sniper for validation.
Overview
| Action |
When to Use |
| New Agent |
New domain/framework expert needed |
| Adapt |
Copy from similar agent (Next.js → React) |
| Update |
Add skills, modify hooks |
Critical Rules
- ALL content in English - Never French or other languages
- Frontmatter complete - name, description, model, tools, skills, hooks
- Agent Workflow section - Always first content section
- SOLID rules reference - Link to solid-[stack] skill
- Register in marketplace.json - Or agent won't load
- Hook scripts executable -
chmod +x
- Output Format section mandatory - Every generated agent must define a standard
## Output Format section (status, files_changed, errors, sources) — an agent invoked by a lead must return structured data, not prose
Architecture
plugins/<plugin-name>/
├── agents/
│ └── <agent-name>.md # Agent definition
├── skills/
│ ├── skill-a/
│ └── solid-[stack]/
├── scripts/
│ └── validate-*.sh # Hook scripts
└── .claude-plugin/
└── plugin.json
→ See architecture.md for details
Reference Guide
Concepts
| Topic |
Reference |
When to Consult |
| Architecture |
architecture.md |
Understanding agent structure |
| Frontmatter |
frontmatter.md |
YAML configuration |
| Required Sections |
required-sections.md |
Mandatory content |
| Hooks |
hooks.md |
Pre/Post tool validation |
| Registration |
registration.md |
marketplace.json |
Templates
| Template |
When to Use |
| agent-template.md |
Creating new agent |
| hook-scripts.md |
Validation scripts |
Quick Reference
Create New Agent
# 1. Research existing agents
→ explore-codebase + research-expert
# 2. Create files
touch plugins/<plugin>/agents/<agent-name>.md
touch plugins/<plugin>/scripts/validate-<stack>-solid.sh
chmod +x plugins/<plugin>/scripts/*.sh
# 3. Register in marketplace.json
# 4. Validate
→ sniper
Adapt Existing Agent
# 1. Copy similar agent
cp plugins/nextjs-expert/agents/nextjs-expert.md plugins/new-plugin/agents/new-expert.md
# 2. Adapt with sed
sed -i '' "s/nextjs/newstack/g; s/Next\.js/NewStack/g" agents/new-expert.md
# 3. Update skills, tools, register
Validation Checklist
Related: Skill Creator
When creating an agent, you often need to create skills too.
Use /fuse-ai-pilot:skill-creator to create skills for the agent:
| Scenario |
Action |
| New agent needs skills |
Create skills with skill-creator first |
| Agent references skills |
Ensure skills exist in skills/ |
| Adapting agent |
Adapt related skills too |
Best Practices
DO
- Use skill-creator for associated skills
- Reference solid-[stack] skill for SOLID rules
- Include Gemini Design section for UI agents
- Make hook scripts executable
DON'T
- Write in French (English only)
- Skip Agent Workflow section
- Forget marketplace registration
- Create agent without its skills
- Hard-code paths in hooks (use
$CLAUDE_PLUGIN_ROOT)
1---2name: agent-creator3description: Use when creating expert agents. Generates agent.md with frontmatter, hooks, required sections, and skill references.4versions:5 claude-plugins: "1.35"6user-invocable: true7references: references/architecture.md, references/frontmatter.md, references/required-sections.md, references/hooks.md, references/registration.md, references/templates/agent-template.md, references/templates/hook-scripts.md8related-skills: skill-creator, exploration9metadata:10 source: https://skillmd.com/skills/fusengine/agent-creator11---1213<objective>14Agent Creator scaffolds a complete Claude Code expert agent: frontmatter (name, description, model, tools, skills, hooks), the mandatory Agent Workflow section, hook scripts, and marketplace registration. It covers three flows -- creating a brand-new domain/framework expert, adapting an existing agent to a new stack, and updating an agent's skills or hooks -- each ending with a `fuse-ai-pilot:sniper` validation pass.1516It does not create the skills an agent references -- for that, use `skill-creator`; agent-creator only wires the agent frontmatter and workflow around skills that already exist or are created alongside it.17</objective>1819# Agent Creator2021## Agent Workflow (MANDATORY)2223Before ANY agent creation, delegate via `Agent` — spawn 2 agents in parallel (single message, 2 `Agent` calls). Generated agents carry `Agent` and `SendMessage` in their tools, so this same pattern is what they must use internally too:24251. **fuse-ai-pilot:explore-codebase** - Check existing agents, analyze patterns262. **fuse-ai-pilot:research-expert** - Fetch latest agent conventions2728`mcp__context7__query-docs` is a direct MCP call, not a spawned agent — invoke it directly (alongside the 2 Task calls) to get examples from existing agents.2930After creation, run **fuse-ai-pilot:sniper** for validation.3132---3334## Overview3536| Action | When to Use |37|--------|-------------|38| **New Agent** | New domain/framework expert needed |39| **Adapt** | Copy from similar agent (Next.js → React) |40| **Update** | Add skills, modify hooks |4142---4344## Critical Rules45461. **ALL content in English** - Never French or other languages472. **Frontmatter complete** - name, description, model, tools, skills, hooks483. **Agent Workflow section** - Always first content section494. **SOLID rules reference** - Link to solid-[stack] skill505. **Register in marketplace.json** - Or agent won't load516. **Hook scripts executable** - `chmod +x`527. **Output Format section mandatory** - Every generated agent must define a standard `## Output Format` section (status, files_changed, errors, sources) — an agent invoked by a lead must return structured data, not prose5354---5556## Architecture5758```59plugins/<plugin-name>/60├── agents/61│ └── <agent-name>.md # Agent definition62├── skills/63│ ├── skill-a/64│ └── solid-[stack]/65├── scripts/66│ └── validate-*.sh # Hook scripts67└── .claude-plugin/68 └── plugin.json69```7071→ See [architecture.md](references/architecture.md) for details7273---7475## Reference Guide7677### Concepts7879| Topic | Reference | When to Consult |80|-------|-----------|-----------------|81| **Architecture** | [architecture.md](references/architecture.md) | Understanding agent structure |82| **Frontmatter** | [frontmatter.md](references/frontmatter.md) | YAML configuration |83| **Required Sections** | [required-sections.md](references/required-sections.md) | Mandatory content |84| **Hooks** | [hooks.md](references/hooks.md) | Pre/Post tool validation |85| **Registration** | [registration.md](references/registration.md) | marketplace.json |8687### Templates8889| Template | When to Use |90|----------|-------------|91| [agent-template.md](references/templates/agent-template.md) | Creating new agent |92| [hook-scripts.md](references/templates/hook-scripts.md) | Validation scripts |9394---9596## Quick Reference9798### Create New Agent99100```bash101# 1. Research existing agents102→ explore-codebase + research-expert103104# 2. Create files105touch plugins/<plugin>/agents/<agent-name>.md106touch plugins/<plugin>/scripts/validate-<stack>-solid.sh107chmod +x plugins/<plugin>/scripts/*.sh108109# 3. Register in marketplace.json110111# 4. Validate112→ sniper113```114115### Adapt Existing Agent116117```bash118# 1. Copy similar agent119cp plugins/nextjs-expert/agents/nextjs-expert.md plugins/new-plugin/agents/new-expert.md120121# 2. Adapt with sed122sed -i '' "s/nextjs/newstack/g; s/Next\.js/NewStack/g" agents/new-expert.md123124# 3. Update skills, tools, register125```126127---128129## Validation Checklist130131- [ ] ALL content in English132- [ ] Frontmatter complete (name, description, model, tools, skills)133- [ ] Agent Workflow section present134- [ ] Mandatory Skills Usage table135- [ ] SOLID Rules reference to solid-[stack]136- [ ] Local Documentation paths valid137- [ ] Output Format section present (status, files_changed, errors, sources)138- [ ] Hook scripts executable139- [ ] Registered in marketplace.json140141---142143## Related: Skill Creator144145**When creating an agent, you often need to create skills too.**146147Use **`/fuse-ai-pilot:skill-creator`** to create skills for the agent:148149| Scenario | Action |150|----------|--------|151| New agent needs skills | Create skills with skill-creator first |152| Agent references skills | Ensure skills exist in skills/ |153| Adapting agent | Adapt related skills too |154155---156157## Best Practices158159### DO160- Use skill-creator for associated skills161- Reference solid-[stack] skill for SOLID rules162- Include Gemini Design section for UI agents163- Make hook scripts executable164165### DON'T166- Write in French (English only)167- Skip Agent Workflow section168- Forget marketplace registration169- Create agent without its skills170- Hard-code paths in hooks (use `$CLAUDE_PLUGIN_ROOT`)