home / skills / fusengine / agents / agent-creator

agent-creator skill

safe

This skill generates agent.md frontmatter, hooks, required sections, and references to solid-[stack] skills to accelerate expert agent creation.

npx playbooks add skill fusengine/agents --skill agent-creator

Review the files below or copy the command above to add this skill to your agents.

Files (8)

SKILL.md

4.4 KB

---
name: agent-creator
description: Use when creating expert agents. Generates agent.md with frontmatter, hooks, required sections, and skill references.
versions:
  claude-plugins: "1.35"
user-invocable: true
references: 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.md
related-skills: skill-creator, exploration
---

# Agent Creator

## Agent Workflow (MANDATORY)

Before ANY agent creation, use `TeamCreate` to spawn 3 agents:

1. **fuse-ai-pilot:explore-codebase** - Check existing agents, analyze patterns
2. **fuse-ai-pilot:research-expert** - Fetch latest agent conventions
3. **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

1. **ALL content in English** - Never French or other languages
2. **Frontmatter complete** - name, description, model, tools, skills, hooks
3. **Agent Workflow section** - Always first content section
4. **SOLID rules reference** - Link to solid-[stack] skill
5. **Register in marketplace.json** - Or agent won't load
6. **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](references/architecture.md) for details

---

## Reference Guide

### Concepts

| Topic | Reference | When to Consult |
|-------|-----------|-----------------|
| **Architecture** | [architecture.md](references/architecture.md) | Understanding agent structure |
| **Frontmatter** | [frontmatter.md](references/frontmatter.md) | YAML configuration |
| **Required Sections** | [required-sections.md](references/required-sections.md) | Mandatory content |
| **Hooks** | [hooks.md](references/hooks.md) | Pre/Post tool validation |
| **Registration** | [registration.md](references/registration.md) | marketplace.json |

### Templates

| Template | When to Use |
|----------|-------------|
| [agent-template.md](references/templates/agent-template.md) | Creating new agent |
| [hook-scripts.md](references/templates/hook-scripts.md) | Validation scripts |

---

## Quick Reference

### Create New Agent

```bash
# 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

```bash
# 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`)

Overview

This skill helps create expert agents by generating a complete agent.md with frontmatter, required sections, hooks, and skill references. It codifies the mandatory agent workflow, validation steps, and registration requirements so new agents are consistent and deployable. It is optimized for TypeScript plugin repositories and integrates with existing agent conventions.

How this skill works

When invoked, the skill generates an agent definition file populated with frontmatter (name, description, model, tools, skills, hooks) and inserts the Agent Workflow section as the first content block. It also scaffolds hook scripts, adds references to required skills (including the solid-[stack] SOLID rules reference), and reminds you to register the agent in marketplace.json. After creation it triggers validation guidance to run the sniper validator and confirms hooks are executable.

When to use it

Creating a new domain or framework expert agent from scratch
Adapting a similar agent (example: Next.js → newstack) to a new stack
Updating an agent to add skills, tools, or modify hooks
Onboarding a plugin repo to the marketplace to ensure correct registration

Best practices

Always include the Agent Workflow section as the first section of the agent file
Populate full frontmatter fields: name, description, model, tools, skills, hooks
Create related skills first with the skill-creator and reference them in skills/
Reference the solid-[stack] skill for SOLID rules and include mandatory skills usage table
Make hook scripts executable (chmod +x) and avoid hard-coded paths—use $CLAUDE_PLUGIN_ROOT

Example use cases

Scaffold a new plugin agent that acts as a framework expert and registers in marketplace.json
Copy and adapt an existing agent file to support a similar technology with sed or search/replace
Generate validation hook scripts for pre/post tool checks and mark them executable
Create an agent that links to newly created skills and includes a Gemini Design section for UI agents

FAQ

What must appear first in every agent file?

The Agent Workflow section must be the first content section in every agent definition.

How do I ensure hooks run correctly?

Place hook scripts in the plugin scripts folder, mark them executable, and use $CLAUDE_PLUGIN_ROOT instead of hard-coded paths.