/persona-import

name: persona-import
description: This skill should be used when the user asks to "import a paperclip agent", "convert paperclip to woterclip", "migrate from paperclip", "import persona from paperclip", or wants to convert existing Paperclip agent directories into WoterClip persona format.
version: 0.1.0

Import Persona from Paperclip

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

Prerequisites

• `.woterclip/config.yaml` must exist (run `/woterclip-init` first)
• User must provide the path to the Paperclip agent directory

File Mapping

| 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 `gh` CLI equivalents | | `life/`, `memory/` | Skip | Claude Code has built-in memory |

Import Procedure

Step 1: Read Source

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.

Step 2: Ask for Persona Details

Ask the user: 1. **Persona name** — e.g., "Backend Engineer" (pre-fill from SOUL.md if obvious) 2. **GitHub label** — e.g., `backend` (must be unique) 3. **Role type** — `engineer`, `orchestrator`, `analyst`, or custom 4. **Model** — `opus`, `sonnet`, or `haiku` (suggest based on role) 5. **Escalates to** — default: `ceo`

Step 3: Transform SOUL.md

1. Start with the Paperclip `SOUL.md` content 2. From `HEARTBEAT.md`: extract the role-specific section (usually the bottom half, after the generic heartbeat steps). Append as a "## Working Style" or "## Role Responsibilities" section 3. From `AGENTS.md`: extract safety rules and boundaries. Append to the "## Boundaries" section 4. Add a WoterClip-specific "## Quality Checklist" section if not present 5. Drop any Paperclip-specific references (workspace paths, PARA memory, budget tracking)

Step 4: Transform TOOLS.md

1. Start with the Paperclip `TOOLS.md` content 2. Replace Paperclip API references:

• `paperclip` skill → `gh` CLI commands (`gh issue view/edit/comment`, etc.)
• `para-memory-files` → drop (replaced by Claude Code built-in memory)
• Paperclip API calls (`POST /checkout`, `PATCH /api/issues`) → `gh` CLI equivalents

3. Add a "## Required" section listing `gh` and any other tools 4. If AGENTS.md references playbooks, note them for manual migration

Step 5: Generate config.yaml

Create the persona config:

name: <Name>
role: <role>
label: <label>
escalates_to: <escalates_to>

required_tools:
  - gh
  # 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: []

Step 6: Write Files

1. Create `.woterclip/personas/<label>/` 2. Write `SOUL.md`, `TOOLS.md`, `config.yaml` 3. Update `.woterclip/config.yaml` to add the persona to the `personas` map 4. Create the GitHub label if it doesn't exist (`gh label create`)

Step 7: Summary

Imported: <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.