# 06 Agent Generate

> Generate an agent across the host AI tools a project uses. Use when the user wants to create, scaffold, or refactor an agent, subagent or specialized role. Not for other artifacts like skills, rules, commands, hooks.

- Skill: `ai-driven-dev/06-agent-generate` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add ai-driven-dev/06-agent-generate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai-driven-dev/06-agent-generate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ai-driven-dev (https://skillmd.com/u/ai-driven-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ai-driven-dev/06-agent-generate

---


# Agent Generate

Write one canonical agent from intent and render it per confirmed host tool, or once as a plugin source.

## Actions

| #   | Action          | Role                                           | Input        |
| --- | --------------- | ---------------------------------------------- | ------------ |
| 01  | `capture-agent` | Gather the role, propose names, pick the model | user request |
| 02  | `write-agent`   | Render the agent per tool and write            | the role     |
| 03  | `validate`      | Check each agent file                          | the files    |

Run the actions in order, `01 → 03`, and run each action's `## Test` before the next.
Before running an action, read its file in `actions/`, not only the table or assets.

## References

- `references/agent-authoring.md`: the contract (frontmatter, body shape, naming, quality).
- `references/tool-paths.md`: per-tool agent path, frontmatter, format conversions, the gate.

## Assets

- `assets/agent-template.md`: agent file scaffold.