Agent Creator

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
└── .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

• [ ] 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 $CLAUDE_PLUGIN_ROOT)