AI Skill MartBrowse skillsPromptsProgramsLearnWhat is a Skill?
 
← Back to list

Paperclip Agent Adapter Builder

An engineering skill for scaffolding and registering Paperclip agent adapters that satisfy the server, UI, and CLI surfaces at once.

Dev & CodingAdvanced★ 112,322⑂ 18,624AI score 8/10Last updated: Nov 8, 2026

What it does

  • Lays out the directory layout and four-export convention for an adapter package that bridges Paperclip's orchestration layer to a specific agent runtime (Claude Code, Codex CLI, a custom process, an HTTP endpoint).
  • Spells out the AdapterExecutionContext → AdapterExecutionResult execution contract, sessionCodec serialization, and the testEnvironment diagnostics contract (pass/warn/fail) with code samples.
  • Ships a registration checklist for all three registries, the full PAPERCLIP_* env-var table, and a reference table of server-utils helpers.
  • Covers session resume (cwd-aware guards, unknown-session retry with clearSession), clean skill injection (tmpdir + --add-dir), and security rules (treat agent stdout as untrusted, inject secrets via env only).

Who it's for

  • Backend/fullstack engineers contributing to the Paperclip repo or running an internal fork.
  • Platform engineers who must wire a new CLI or API agent into Paperclip.
  • Anyone looking for a reference architecture for adapters in a multi-agent orchestrator.

Examples

  1. "Add an adapter for Gemini CLI" → scaffolds packages/adapters/gemini-local/, writes type/label/models/agentConfigurationDoc, and registers it in all three registries.
  2. "Fix claude_local resuming a session from a different project" → applies the cwd-match resume guard and the clearSession: true retry pattern.
  3. "Wire up the Test environment button for my adapter" → builds server/test.ts checks for cwd, command resolution, and URLs, then computes final status per the error/warn/info severity policy.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/paperclipai/paperclip/HEAD/.agents/skills/create-agent-adapter/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on AI Skill Mart.
Copy the .agents/skills/create-agent-adapter folder from the GitHub repo paperclipai/paperclip into my ~/.claude/skills/create-agent-adapter/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/paperclipai/paperclip.git /tmp/paperclip && mkdir -p ~/.claude/skills && cp -r /tmp/paperclip/.agents/skills/create-agent-adapter ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and change into your working folder.
  2. Clone the repository: git clone https://github.com/paperclipai/paperclip.git
  3. Create the skills folder: mkdir -p ~/.claude/skills
  4. Copy the skill in: cp -r paperclip/.agents/skills/create-agent-adapter ~/.claude/skills/
  5. Restart Claude Code and confirm create-agent-adapter shows up in your skill list.
  6. Use it from inside the Paperclip monorepo — ask something like "create a new adapter package" to trigger it.
View source on GitHub ↗License: MIT