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-builder

Agent 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):

  1. Job statement: What is the agent’s primary mission in one sentence?
  2. Surfaces: Which channels (Telegram/WhatsApp/Discord/iMessage)? DM only vs groups?
  3. Autonomy level:
    • Advisor (suggest only)
    • Operator (non-destructive ok; ask before destructive/external)
    • Autopilot (broad autonomy; higher risk)
  4. Hard prohibitions: Any actions the agent must never take?
  5. Memory: Should it keep curated MEMORY.md? What categories matter?
  6. Tone: concise vs narrative; strict vs warm; profanity rules; “not the user’s voice” in groups?
  7. Tool posture: tool-first vs answer-first; verification requirements.

Phase 2 — Generate workspace files

Generate these files (minimum viable OpenClaw agent):

  • IDENTITY.md
  • SOUL.md
  • AGENTS.md
  • USER.md
  • HEARTBEAT.md (often empty by default)

Optionals:

  • MEMORY.md (private sessions only)
  • memory/YYYY-MM-DD.md seed (today) with a short “agent created” entry
  • TOOLS.md starter (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:

  1. What are the top 3 failure modes you’ve seen? (loops, overreach, verbosity, etc.)
  2. What autonomy changes do you want?
  3. Any new safety boundaries?
  4. 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

@ivangdavila

Designs, 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`).

42.4k

Open Persona

@neiljo-gy

Meta-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

12.1k

Openclaw Agent Optimize

@phenomenoner

Use when: you want a structured audit -> options -> recommended plan to improve an OpenClaw workspace (cost, model routing, context discipline, delegation, r...

5013k

Skill Creator

@chindden

Guide 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.

33397k

Resume Builder

@amruthpillai

Generate 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.

74.1k

Skill Creator

@yixinli867

Guide 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.

3913k