agent-creator

name	agent-creator
description	Creates specialized AI agents on-demand when no existing agent matches a request. Use when the Router cannot find a suitable agent for a task. Enables self-evolution by generating persistent agents.
version	2.3.0
model	sonnet
invoked_by	both
user_invocable	true
tools	["Read","Write","Edit","Glob","Grep","WebSearch","WebFetch","Bash","Task"]
args	<agent-name> [options] [--eval] [--eval --tier light]
best_practices	["Verify no existing agent matches first","Research domain before creating agent","Align agent to BLS OOH occupational profiles (Step 2.3)","Compare against Ongig job titles for routing keywords","Use MyMajors career skills for real-world skill grounding","Run skills gap analysis and record follow-up items for reusable skill gaps","Assign relevant skills to new agents"]
error_handling	graceful
streaming	supported
output_location	.claude/agents/
verified	true
lastVerifiedAt	2026-02-28
dependencies	["research-synthesis"]
source	builtin
trust_score	100
provenance_sha	7c35f8976f0fcb92

Mode: Script-First - Use scripts/main.cjs as the canonical path for generation and validation, then use this guide for research, skill assignment, and integration follow-through.

Agent Creator Skill

Creates specialized AI agents on-demand for capabilities that do not already have a good owner.

When This Skill Is Triggered

1. The router finds no suitable existing agent.
2. The user explicitly asks for a new agent.
3. A capability gap requires a persistent specialist rather than a one-off task.

Reference Docs

• Occupational alignment details - preserved router notes, trigger guidance, companion checks, domain research, and occupational-alignment fetch details.
• Research and skills-gap details - preserved keyword research, skill discovery, configuration notes, and the full template contract reference.
• Integration reference - preserved validation, routing-table, registry, memory, README, and ecosystem-integration guidance.
• Examples and evaluation - preserved workflow integration notes, ecosystem alignment contract, examples, assertions, and optional eval add-ons.

Quick Reference

| Operation | Primary command or tool | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------- | --------------- | | Check for existing agents | Glob: .claude/agents/**/*.md | | Generate the managed template | node .claude/skills/agent-creator/scripts/main.cjs --action generate --name <agent-name> --description "<summary>" --category <core | domain | specialized | orchestrators> | | Validate the managed template | node .claude/skills/agent-creator/scripts/main.cjs --action validate --file .claude/agents/<category>/<agent-name>.md | | Research the role | Follow occupational alignment details and research and skills-gap details | | Final integration | Follow integration reference |