From woterclip
Converts Paperclip agent directories to WoterClip persona format by mapping SOUL.md, HEARTBEAT.md, AGENTS.md, and TOOLS.md to SOUL.md, TOOLS.md, and config.yaml.
How this skill is triggered — by the user, by Claude, or both
Slash command
/woterclip:persona-importThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Convert a Paperclip agent directory into a WoterClip persona. Maps Paperclip's agent structure (SOUL.md, AGENTS.md, HEARTBEAT.md, TOOLS.md) to WoterClip's persona structure (SOUL.md, TOOLS.md, config.yaml).
Convert a Paperclip agent directory into a WoterClip persona. Maps Paperclip's agent structure (SOUL.md, AGENTS.md, HEARTBEAT.md, TOOLS.md) to WoterClip's persona structure (SOUL.md, TOOLS.md, config.yaml).
.woterclip/config.yaml must exist (run /woterclip-init first)| Paperclip File | WoterClip Target | What to Import |
|---|---|---|
SOUL.md | SOUL.md | Copy as-is — identity, posture, voice |
HEARTBEAT.md | Append to SOUL.md | Only the role-specific responsibilities section (bottom). Skip the generic heartbeat procedure (top) — replaced by the plugin's heartbeat skill |
AGENTS.md | config.yaml + SOUL.md | Safety rules → append to SOUL.md Boundaries section. Workspace paths → drop. Memory refs → drop |
TOOLS.md | TOOLS.md | Copy, replacing Paperclip API references with Linear MCP equivalents |
life/, memory/ | Skip | Claude Code has built-in memory |
Ask the user for the Paperclip agent directory path. Read all files present:
SOUL.md (required)AGENTS.md (optional)HEARTBEAT.md (optional)TOOLS.md (optional)If SOUL.md doesn't exist, stop — this is not a valid Paperclip agent directory.
Ask the user:
backend (must be unique)engineer, orchestrator, analyst, or customopus, sonnet, or haiku (suggest based on role)ceoSOUL.md contentHEARTBEAT.md: extract the role-specific section (usually the bottom half, after the generic heartbeat steps). Append as a "## Working Style" or "## Role Responsibilities" sectionAGENTS.md: extract safety rules and boundaries. Append to the "## Boundaries" sectionTOOLS.md contentpaperclip skill → mcp__claude_ai_Linear__* (Linear MCP tools)para-memory-files → drop (replaced by Claude Code built-in memory)POST /checkout, PATCH /api/issues) → Linear MCP equivalentsmcp__claude_ai_Linear and any other tool prefixesCreate the persona config:
name: <Name>
role: <role>
label: <label>
escalates_to: <escalates_to>
required_tools:
- mcp__claude_ai_Linear
# additional tools based on TOOLS.md
runtime:
model: <model>
thinking_effort: <high for opus, medium otherwise>
max_turns: <300 for opus, 200 for sonnet, 100 for haiku>
enable_chrome: false
timeout: 0
extra_args: []
.woterclip/personas/<label>/SOUL.md, TOOLS.md, config.yaml.woterclip/config.yaml to add the persona to the personas mapImported: <Name> (from <source-path>)
Label: <label>
Model: <model>
Files created:
✓ .woterclip/personas/<label>/SOUL.md
✓ .woterclip/personas/<label>/TOOLS.md
✓ .woterclip/personas/<label>/config.yaml
What was imported:
✓ SOUL.md — identity and posture
✓ HEARTBEAT.md — role responsibilities (appended to SOUL.md)
✓ AGENTS.md — safety rules (appended to Boundaries)
✓ TOOLS.md — tool list (Paperclip refs replaced)
What was NOT imported:
✗ Budget tracking (no WoterClip equivalent)
✗ PARA memory (replaced by Claude Code built-in memory)
✗ Approval workflows (not in v1)
Review SOUL.md and customize for this project's specific needs.
npx claudepluginhub wotai-dev/woterclip --plugin woterclipImports an OpenClaw agent workspace (SOUL.md, IDENTITY.md, MEMORY.md, etc.) into the current project. Useful when migrating or referencing an agent's identity and memory.
Interactively creates WoterClip personas by gathering details, generating SOUL.md, TOOLS.md, config.yaml, updating repo config, and creating Linear labels. Triggers on /persona-create or persona requests.
Runs a checklist for onboarding new agents to the bOpen team: design, write, avatar, plugin, Paperclip registration, roster, and optional ClawNet bot deployment.