$npx -y skills add fusengine/agents --skill agent-creatorUse when creating expert agents. Generates agent.md with frontmatter, hooks, required sections, and skill references.
| 1 | # Agent Creator |
| 2 | |
| 3 | ## Agent Workflow (MANDATORY) |
| 4 | |
| 5 | Before ANY agent creation, delegate via `Task` — spawn 2 agents in parallel (single message, 2 Task calls). Generated agents only carry `Task` in their tools (no `TeamCreate`), so this same pattern is what they must use internally too: |
| 6 | |
| 7 | 1. **fuse-ai-pilot:explore-codebase** - Check existing agents, analyze patterns |
| 8 | 2. **fuse-ai-pilot:research-expert** - Fetch latest agent conventions |
| 9 | |
| 10 | `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. |
| 11 | |
| 12 | After creation, run **fuse-ai-pilot:sniper** for validation. |
| 13 | |
| 14 | --- |
| 15 | |
| 16 | ## Overview |
| 17 | |
| 18 | | Action | When to Use | |
| 19 | |--------|-------------| |
| 20 | | **New Agent** | New domain/framework expert needed | |
| 21 | | **Adapt** | Copy from similar agent (Next.js → React) | |
| 22 | | **Update** | Add skills, modify hooks | |
| 23 | |
| 24 | --- |
| 25 | |
| 26 | ## Critical Rules |
| 27 | |
| 28 | 1. **ALL content in English** - Never French or other languages |
| 29 | 2. **Frontmatter complete** - name, description, model, tools, skills, hooks |
| 30 | 3. **Agent Workflow section** - Always first content section |
| 31 | 4. **SOLID rules reference** - Link to solid-[stack] skill |
| 32 | 5. **Register in marketplace.json** - Or agent won't load |
| 33 | 6. **Hook scripts executable** - `chmod +x` |
| 34 | 7. **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 |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## Architecture |
| 39 | |
| 40 | ``` |
| 41 | plugins/<plugin-name>/ |
| 42 | ├── agents/ |
| 43 | │ └── <agent-name>.md # Agent definition |
| 44 | ├── skills/ |
| 45 | │ ├── skill-a/ |
| 46 | │ └── solid-[stack]/ |
| 47 | ├── scripts/ |
| 48 | │ └── validate-*.sh # Hook scripts |
| 49 | └── .claude-plugin/ |
| 50 | └── plugin.json |
| 51 | ``` |
| 52 | |
| 53 | → See [architecture.md](references/architecture.md) for details |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## Reference Guide |
| 58 | |
| 59 | ### Concepts |
| 60 | |
| 61 | | Topic | Reference | When to Consult | |
| 62 | |-------|-----------|-----------------| |
| 63 | | **Architecture** | [architecture.md](references/architecture.md) | Understanding agent structure | |
| 64 | | **Frontmatter** | [frontmatter.md](references/frontmatter.md) | YAML configuration | |
| 65 | | **Required Sections** | [required-sections.md](references/required-sections.md) | Mandatory content | |
| 66 | | **Hooks** | [hooks.md](references/hooks.md) | Pre/Post tool validation | |
| 67 | | **Registration** | [registration.md](references/registration.md) | marketplace.json | |
| 68 | |
| 69 | ### Templates |
| 70 | |
| 71 | | Template | When to Use | |
| 72 | |----------|-------------| |
| 73 | | [agent-template.md](references/templates/agent-template.md) | Creating new agent | |
| 74 | | [hook-scripts.md](references/templates/hook-scripts.md) | Validation scripts | |
| 75 | |
| 76 | --- |
| 77 | |
| 78 | ## Quick Reference |
| 79 | |
| 80 | ### Create New Agent |
| 81 | |
| 82 | ```bash |
| 83 | # 1. Research existing agents |
| 84 | → explore-codebase + research-expert |
| 85 | |
| 86 | # 2. Create files |
| 87 | touch plugins/<plugin>/agents/<agent-name>.md |
| 88 | touch plugins/<plugin>/scripts/validate-<stack>-solid.sh |
| 89 | chmod +x plugins/<plugin>/scripts/*.sh |
| 90 | |
| 91 | # 3. Register in marketplace.json |
| 92 | |
| 93 | # 4. Validate |
| 94 | → sniper |
| 95 | ``` |
| 96 | |
| 97 | ### Adapt Existing Agent |
| 98 | |
| 99 | ```bash |
| 100 | # 1. Copy similar agent |
| 101 | cp plugins/nextjs-expert/agents/nextjs-expert.md plugins/new-plugin/agents/new-expert.md |
| 102 | |
| 103 | # 2. Adapt with sed |
| 104 | sed -i '' "s/nextjs/newstack/g; s/Next\.js/NewStack/g" agents/new-expert.md |
| 105 | |
| 106 | # 3. Update skills, tools, register |
| 107 | ``` |
| 108 | |
| 109 | --- |
| 110 | |
| 111 | ## Validation Checklist |
| 112 | |
| 113 | - [ ] ALL content in English |
| 114 | - [ ] Frontmatter complete (name, description, model, tools, skills) |
| 115 | - [ ] Agent Workflow section present |
| 116 | - [ ] Mandatory Skills Usage table |
| 117 | - [ ] SOLID Rules reference to solid-[stack] |
| 118 | - [ ] Local Documentation paths valid |
| 119 | - [ ] Output Format section present (status, files_changed, errors, sources) |
| 120 | - [ ] Hook scripts executable |
| 121 | - [ ] Registered in marketplace.json |
| 122 | |
| 123 | --- |
| 124 | |
| 125 | ## Related: Skill Creator |
| 126 | |
| 127 | **When creating an agent, you often need to create skills too.** |
| 128 | |
| 129 | Use **`/fuse-ai-pilot:skill-creator`** to create skills for the agent: |
| 130 | |
| 131 | | Scenario | Action | |
| 132 | |----------|--------| |
| 133 | | New agent needs skills | Create skills with skill-creator first | |
| 134 | | Agent references skills | Ensure skills exist in skills/ | |
| 135 | | Adapting agent | Adapt related skills too | |
| 136 | |
| 137 | --- |
| 138 | |
| 139 | ## Best Practices |
| 140 | |
| 141 | ### DO |
| 142 | - Use skill-creator for associated skills |
| 143 | - Reference solid-[stack] skill for SOLID rules |
| 144 | - Include Gemini Design section for UI agents |
| 145 | - Make hook scripts executable |
| 146 | |
| 147 | ### DON'T |
| 148 | - Write in French (English only) |
| 149 | - Skip Agent Workflow section |
| 150 | - Forget marketplace registration |
| 151 | - Create agent without its skills |
| 152 | - Hard-code paths in hooks (use `$CLAUDE_PLUGIN_ROOT`) |