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.
npx claudepluginhub wotai-dev/woterclip --plugin woterclipThis skill uses the workspace's default tool permissions.
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).
Imports OpenClaw agents from workspace directories into current Claude Code projects, copying core MD files, memory with filters, and adapting AGENTS.md for Claude.
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.
Orchestrates AI agent companies with Paperclip, handling org charts, goals, tasks, budgets, heartbeats, governance, and audit logs for multi-agent workflows.
Share bugs, ideas, or general feedback.
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.