Convert OpenClaw skills and agent workspaces into Paperclip-compatible Claude Code agents. Use when you need to import an OpenClaw skill package (manifest .md + scripts) into a Paperclip skills/ directory, or convert an OpenClaw agent workspace (SOUL.md + AGENTS.md + IDENTITY.md) into a Paperclip AGENTS.md with heartbeat procedure. Triggers: "convert openclaw skill", "import openclaw agent", "convert this skill to paperclip", or when given a path to an OpenClaw workspace or skill package.
Convert OpenClaw skills and agents into Claude Code formatted agents and skills that work with Paperclip's control plane.
Mode 1 — Skill Package Conversion
Source: An OpenClaw skill directory containing a manifest .md (YAML frontmatter
with name and description) alongside scripts, requirements, and documentation.
Target: A Paperclip skills/<name>/SKILL.md with optional references/ directory.
Mode 2 — Agent Workspace Conversion
Source: An OpenClaw agent workspace with SOUL.md, AGENTS.md, and IDENTITY.md.
Target: A Paperclip agents/<role>/AGENTS.md with heartbeat procedure, plus a
.paperclip.yaml adapter entry.
Read the source directory and classify:
.md file with YAML frontmatter (,
) alongside executable scripts (, , ), plus optional
, , .namedescription.py.sh.jsrequirements.txtREADME.mdQUICK_START.mdSOUL.md + AGENTS.md + IDENTITY.md
(the three-file OpenClaw format)..md with frontmatter containing color,
emoji, vibe fields. This is NOT an OpenClaw format — advise using
agent-shop/scripts/convert.sh --tool paperclip instead.Mode 1 (Skill Package):
.md file — extract name, description from frontmatter
and the full markdown body.requirements.txt if present (dependency list).README.md / QUICK_START.md if present (supplementary docs).Mode 2 (Agent Workspace):
IDENTITY.md — extract agent name (first # heading) and description.SOUL.md — extract identity, communication style, and critical rules sections.AGENTS.md — extract mission, workflow, deliverables sections.Apply the mapping rules from references/mapping-rules.md.
Mode 1 — Skill Package → SKILL.md:
Write skills/<slug>/SKILL.md with this structure:
---