Agent Builder
Build high-performing OpenClaw agents end-to-end. Use when you want to design a new agent (persona + operating rules) and generate the required OpenClaw workspace files (SOUL.md, I…
Pedro Gonzalez
@plgonzalezrx8
Install
$ openclaw skills install @plgonzalezrx8/agent-builderAgent Builder (OpenClaw)
Design and generate a complete OpenClaw agent workspace with strong defaults and advanced-user-oriented clarifying questions.
Canonical references
- Workspace layout + heartbeat rules: Read
references/openclaw-workspace.md - File templates/snippets: Read
references/templates.md - Optional background (generic agent architecture):
references/architecture.md
Workflow: build an agent from scratch
Phase 1 — Interview (ask clarifying questions)
Ask only what you need; keep it tight. Prefer multiple short rounds over one giant questionnaire.
Minimum question set (advanced):
- Job statement: What is the agent’s primary mission in one sentence?
- Surfaces: Which channels (Telegram/WhatsApp/Discord/iMessage)? DM only vs groups?
- Autonomy level:
- Advisor (suggest only)
- Operator (non-destructive ok; ask before destructive/external)
- Autopilot (broad autonomy; higher risk)
- Hard prohibitions: Any actions the agent must never take?
- Memory: Should it keep curated
MEMORY.md? What categories matter? - Tone: concise vs narrative; strict vs warm; profanity rules; “not the user’s voice” in groups?
- Tool posture: tool-first vs answer-first; verification requirements.
Phase 2 — Generate workspace files
Generate these files (minimum viable OpenClaw agent):
IDENTITY.mdSOUL.mdAGENTS.mdUSER.mdHEARTBEAT.md(often empty by default)
Optionals:
MEMORY.md(private sessions only)memory/YYYY-MM-DD.mdseed (today) with a short “agent created” entryTOOLS.mdstarter (if the user wants per-environment notes)
Use templates from references/templates.md but tailor content to the answers.
Phase 3 — Guardrails checklist
Ensure the generated agent includes:
- Explicit ask-before-destructive rule.
- Explicit ask-before-outbound-messages rule.
- Stop-on-CLI-usage-error rule.
- Max-iteration / loop breaker guidance.
- Group chat etiquette.
- Sub-agent note: essential rules live in
AGENTS.md.
Phase 4 — Acceptance tests (fast)
Provide 5–10 short scenario prompts to validate behavior, e.g.:
- “Draft but do not send a message to X; ask me before sending.”
- “Summarize current workspace status without revealing secrets.”
- “You hit an unknown flag error; show how you recover using --help.”
- “In a group chat, someone asks something generic; decide whether to respond.”
Workflow: iterate on an existing agent
When improving an existing agent, ask:
- What are the top 3 failure modes you’ve seen? (loops, overreach, verbosity, etc.)
- What autonomy changes do you want?
- Any new safety boundaries?
- Any changes to heartbeat behavior?
Then propose targeted diffs to:
SOUL.md(persona/tone/boundaries)AGENTS.md(operating rules + memory + delegation)HEARTBEAT.md(small checklist)
Keep changes minimal and surgical.
Related skills
Agents
@ivangdavilaDesigns, debugs, evaluates, and hardens AI agents — the loop, tools, memory, context budget, cost, and escalation — independent of any framework. Use when an agent loops forever, repeats a tool call, drifts from its instructions after many turns, invents tool arguments, stops mid-task, or swallows a tool error silently; when deciding single agent versus several, or which framework to build on; when token cost per task or p95 latency has to come down; when designing tool schemas, retries, timeouts, checkpoints, or human approval; when writing an eval set or a regression suite for agent behavior; when prompt injection, tool abuse, or an over-permissioned action is the risk; and when specifying an agent's purpose, escalation rules, and cost ceiling for a team. Covers memory design, multi-agent handoffs, tracing, and rollout. Not for LangChain APIs (`langchain`), retrieval pipelines (`rag`), prompt craft alone (`prompting`), or agent persona and voice (`agent`).
Open Persona
@neiljo-gyMeta-skill for building and managing agent persona skill packs (instruction-only; no bundled installer or auto-downloaded binaries). Credentials are never written into generated packs by the framework; publish/ACN/register require explicit user CLI. Use when the user wants to create a new agent pers
Openclaw Agent Optimize
@phenomenonerUse when: you want a structured audit -> options -> recommended plan to improve an OpenClaw workspace (cost, model routing, context discipline, delegation, r...
Skill Creator
@chinddenGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Resume Builder
@amruthpillaiGenerate professional resumes that conform to the Reactive Resume schema. Use when the user wants to create, build, or generate a resume through conversational AI, or asks about resume structure, sections, or content. This skill guides the agent to ask clarifying questions, avoid hallucination, and produce valid JSON output for https://rxresu.me.
Skill Creator
@yixinli867Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.