← Back to Skills Marketplace
Create Agent
by
austindixson
· GitHub ↗
· v1.0.0
483
Downloads
0
Stars
9
Active Installs
1
Versions
Install in OpenClaw
/install create-agent
Description
Creates new Overstory agents for Overclaw by updating all seven integration points (config, manifest, agent-def, gateway prompt, task_router, generate_agent_...
README (SKILL.md)
Create Agent
Creates and registers new Overstory agents so Overclaw can recognize and use them. Automates the steps documented in .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:
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):
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
.overstory/config.yaml— capability entry.overstory/agent-manifest.json— agent + capabilityIndex.overstory/agent-defs/\x3Cname>.md— agent definitionscripts/overclaw_gateway.py— orchestrator system promptskills/nanobot-overstory-bridge/scripts/task_router.py— CAPABILITY_PATTERNSskills/nanobot-overstory-bridge/scripts/generate_agent_context.py— CAPABILITY_PRIVILEGES- Regeneration of gateway-context.md and skills-manifest.json
References
- CREATING_AGENTS.md — Step-by-step explainer
- .overstory/agent-defs/blogger.md — Example agent def
- .overstory/agent-defs/supervisor.md — Example coordinator-style agent
Usage Guidance
This skill appears to do what it says: it edits multiple files in your workspace to register new agents and can analyze logs/docs to suggest agents. Before installing or running it, backup your workspace (or test in a disposable clone), run create_agent.py with --dry-run or --suggest-only first, and inspect the two script files yourself. Note the scripts may call external tools (mulch, generator scripts) and will read files under the workspace and your home (~/.openclaw/logs). If you plan to allow autonomous agent invocation, be aware a compromised or buggy agent could make persistent changes to these project files. If unsure, run the scripts interactively in a safe environment and ensure PyYAML and required CLI tools are installed only when needed.
Capability Analysis
Type: OpenClaw Skill
Name: create-agent
Version: 1.0.0
The skill is designed to modify critical OpenClaw configuration files and Python source code, which is a high-privilege operation. It executes external commands via `subprocess.run` (e.g., `mulch`, `generate_agent_context.py`). A significant vulnerability exists in `scripts/create_agent.py` where user-provided `--description` is directly embedded into generated markdown files (`agent-defs/<name>.md`) without sanitization. This creates a prompt injection risk, allowing an attacker to craft a description that, when processed by an AI agent, could lead to unintended actions like data exfiltration (e.g., via markdown image tags) or arbitrary command execution against the agent.
Capability Assessment
Purpose & Capability
Name/description (create Overstory agents) align with the included scripts and SKILL.md: the code updates the seven listed integration points (config, manifest, agent-defs, gateway prompt, task_router, generate_agent_context, and regeneration). Modifying other workspace scripts (task_router.py, generate_agent_context.py) is expected for this capability.
Instruction Scope
SKILL.md and the scripts are explicit about actions: they read TROUBLESHOOTING.md, logs, project tree, and may call 'mulch' and run the generate_agent_context.py script. This is within the advertised scope, but the scripts will read files in the workspace and in the user's home (e.g., ~/.openclaw/logs) and can spawn subprocesses — so they have broad local file access consistent with their purpose.
Install Mechanism
No install spec; the skill is instruction+script only. No external downloads or archive extraction are present in the package. The code does rely on Python and optional third-party modules (PyYAML) and on external CLI tools (e.g., mulch, gateway tools) if analysis/regeneration features are used.
Credentials
The registry lists no required env vars, which is reasonable. The scripts do read optional environment variables (NANOBOT_WORKSPACE, OPENCLAW_WORKSPACE, and template references to $GATEWAY_TOOLS) and the user's home log directory. No cloud or secret credentials are requested. Access to workspace and home log files is broad but justified by the analysis features.
Persistence & Privilege
always:false (no forced persistence). The script does modify other files in the workspace and other skills' scripts (e.g., nanobot-overstory-bridge), which is necessary for its goal but increases impact if run by an autonomous agent. Autonomous invocation is allowed by default; combine that with file-modifying behavior when deciding trust.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install create-agent - After installation, invoke the skill by name or use
/create-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Create Agent skill for Overclaw.
- Automates creation and registration of new Overstory agents, updating all seven required integration points.
- Supports both manual agent creation and analysis-driven agent suggestions from logs, troubleshooting files, mulch, and project structure.
- Provides `create_agent.py` CLI tool with validation, dry-run, and rollback options.
- Includes helper script `analyze_agent_needs.py` for suggesting agent needs based on project resources.
Metadata
Frequently Asked Questions
What is Create Agent?
Creates new Overstory agents for Overclaw by updating all seven integration points (config, manifest, agent-def, gateway prompt, task_router, generate_agent_... It is an AI Agent Skill for Claude Code / OpenClaw, with 483 downloads so far.
How do I install Create Agent?
Run "/install create-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Create Agent free?
Yes, Create Agent is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Create Agent support?
Create Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Create Agent?
It is built and maintained by austindixson (@austindixson); the current version is v1.0.0.
More Skills