# Create Agent

> Creates new Overstory agents for Overclaw by updating all seven integration points (config, manifest, agent-def, gateway prompt, task_router, generate_agent_context, and regeneration). Supports manual creation and optional analysis from logs, TROUBLESHOOTING.md, mulch, and project tree.

- Skill: `modbender/create-agent` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add modbender/create-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/create-agent/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/create-agent

---


# Create Agent

Creates and registers new Overstory agents so Overclaw can recognize and use them. Automates the steps documented in [.overstory/CREATING_AGENTS.md](../../.overstory/CREATING_AGENTS.md).

## When to use

- You want to add a new agent type (e.g. troubleshooter, docs-writer) to Overclaw.
- You want to ensure all seven integration points are updated consistently.
- You want to suggest new agents from Overclaw logs, TROUBLESHOOTING.md, mulch, or project structure.

## Scripts

### create_agent.py

Main CLI for creating or validating agents.

**Manual creation:**
```bash
python3 scripts/create_agent.py \
  --name "troubleshooter" \
  --description "Analyzes logs and troubleshoots issues" \
  --capabilities "troubleshoot,debug,analyze" \
  --model "sonnet" \
  --tools "Read,Glob,Grep,Bash" \
  --can-spawn false \
  --constraints "read-only"
```

**Options:** `--dry-run` (preview only), `--no-regenerate` (skip gateway context regeneration), `--rollback-on-fail` (revert changes if validation fails).

**Analysis mode (suggestions only):**
```bash
python3 scripts/create_agent.py \
  --analyze-from-logs \
  --analyze-from-troubleshooting \
  --suggest-only
```

### analyze_agent_needs.py

Helper for analysis mode: parses logs, TROUBLESHOOTING.md, mulch, and project tree to suggest new agent definitions. Can be run standalone or via create_agent.py `--analyze-*`.

## Integration points updated

1. `.overstory/config.yaml` — capability entry
2. `.overstory/agent-manifest.json` — agent + capabilityIndex
3. `.overstory/agent-defs/<name>.md` — agent definition
4. `scripts/overclaw_gateway.py` — orchestrator system prompt
5. `skills/nanobot-overstory-bridge/scripts/task_router.py` — CAPABILITY_PATTERNS
6. `skills/nanobot-overstory-bridge/scripts/generate_agent_context.py` — CAPABILITY_PRIVILEGES
7. Regeneration of gateway-context.md and skills-manifest.json

## References

- [CREATING_AGENTS.md](../../.overstory/CREATING_AGENTS.md) — Step-by-step explainer
- [.overstory/agent-defs/blogger.md](../../.overstory/agent-defs/blogger.md) — Example agent def
- [.overstory/agent-defs/supervisor.md](../../.overstory/agent-defs/supervisor.md) — Example coordinator-style agent