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 )