fusengine Agent Creator
Agent Workflow (MANDATORY)
Before ANY agent creation, use TeamCreate to spawn 3 agents:
- fuse-ai-pilot:explore-codebase - Check existing agents, analyze patterns
- fuse-ai-pilot:research-expert - Fetch latest agent conventions
- mcp__context7__query-docs - 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
Architecture
plugins/<plugin-name>/
├── agents/
│ └── <agent-name>.md # Agent definition
├── skills/
│ ├── skill-a/
│ └── solid-[stack]/
├── scripts/
│ └── validate-*.sh # Hook scripts
└── .codex-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
- ALL content in English
- Frontmatter complete (name, description, model, tools, skills)
- Agent Workflow section present
- Mandatory Skills Usage table
- SOLID Rules reference to solid-[stack]
- Local Documentation paths valid
- Hook scripts executable
- Registered in marketplace.json
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
$PLUGIN_ROOT)