LeoYeAI/agent-master-skills / skills/agent-builder-plus
agent-builder-plus
UnverifiedBuild high-performing OpenClaw agents end-to-end with comprehensive safety features. Use when you want to design a new agent (persona + operating rules) and generate required OpenClaw workspace files (SOUL.md, IDENTITY.md, AGENTS.md, USER.md, HEARTBEAT.md, optional MEMORY.md + memory/YYYY-MM-DD.md). Includes anti-deadlock protection, timeout handling, error recovery, loop breaker, message overload protection, token limit protection, retry mechanism, health check, degraded mode, monitoring & logging, configuration validation, and channel conflict prevention. Also use to iterate on an existing agent's behavior, guardrails, autonomy model, heartbeat plan, and skill roster.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.7 KB |
| _meta.json | config | 466 B |
| references/architecture.md | markdown | 2.2 KB |
| references/openclaw-workspace.md | markdown | 2.2 KB |
| references/templates.md | markdown | 13.9 KB |
references/openclaw-workspace.md
View on GitHub# OpenClaw agent workspace (cheat sheet)
This reference is for building **OpenClaw-specific agents** (not generic LLM “agents”).
## Workspace layout (canonical)
Workspace = agent’s “home” directory.
Common files at workspace root:
- `AGENTS.md` — operating instructions (how to behave, safety rules, memory workflow)
- `SOUL.md` — persona, tone, boundaries
- `IDENTITY.md` — name/vibe/emoji (short)
- `USER.md` — who the user is + how to address them
- `TOOLS.md` — local notes + conventions (NOT tool availability)
- `HEARTBEAT.md` — optional heartbeat checklist (keep tiny)
- `BOOTSTRAP.md` — one-time first-run ritual; delete after completed
- `MEMORY.md` — optional curated long-term memory (private sessions only)
- `memory/YYYY-MM-DD.md` — daily logs
- `skills/` — optional workspace-specific skills
## What NOT to store in the workspace
Do not commit secrets or credentials. Keep these out of the workspace repo:
- `~/.openclaw/openclaw.json` (config)
- `~/.openclaw/credentials/` (OAuth tokens, API keys)
- `~/.openclaw/agents/<agentId>/sessions/` (session transcripts)
## Heartbeats
Default heartbeat prompt:
`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`
Best practices:
- Keep `HEARTBEAT.md` extremely short.
- If `HEARTBEAT.md` exists but is effectively empty (only blank lines / headers), OpenClaw can skip heartbeat runs.
- Heartbeats burn tokens; enable only once you trust the agent.
## Safety defaults (recommended)
- Never run destructive/state-changing actions without explicit permission.
- Never send outbound messages/emails/posts unless explicitly asked.
- Prefer `trash` over `rm`.
- Stop on CLI usage errors; run `--help` and correct.
- In group chats: don’t be the user’s voice; respond only when mentioned or clearly useful.
## Sub-agents (important)
Sub-agents do not receive full bootstrap files. In particular, sub-agents only get `AGENTS.md` + `TOOLS.md` by default (not `SOUL.md`, `USER.md`, etc.).
Implication: if you delegate, ensure `AGENTS.md` contains the cross-cutting safety and operating rules you need sub-agents to follow.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |