Skip to content
Get packs

Create Agent Adapter

Guides building or changing a Paperclip adapter that connects an AI agent runtime to server, UI and CLI.

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
1 file

What it does

This skill gives an AI agent a detailed playbook for writing a Paperclip adapter, which is a self-contained package that lets Paperclip's orchestration layer drive a specific AI agent (such as Claude Code, Codex CLI, a custom process or an HTTP endpoint). Once installed, the agent knows the required folder layout, the TypeScript interfaces each part must implement, the environment-test contract, and the step-by-step process for adding or modifying an adapter across the server, UI and CLI.

Great for

  • Developers extending the Paperclip codebase with support for a new agent runtime
  • Maintainers who need to modify an existing adapter across server, UI and CLI consistently
  • Teams writing a custom adapter package for an internal CLI or HTTP agent

Skip it if

  • People who just want to use Paperclip or run an existing agent; this is a contributor guide, not an end-user tool
  • Non-developers, since the output is TypeScript package code that must be reviewed and tested before it is merged
  • Projects outside Paperclip, because the interfaces and registry paths are specific to its repository

Try asking

  • “Add support for a new CLI agent to Paperclip as an adapter package”
  • “Modify the server execute function of the existing claude_local adapter to persist session state”
  • “Create a testEnvironment check that warns when an ambient API key overrides subscription login”
  • “Scaffold the packages/adapters/<name> folder with package.json, tsconfig and the server, ui and cli entry files”
Step-by-step guide: how to use Create Agent AdapterInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    create-agent-adapter.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip create-agent-adapter.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip create-agent-adapter.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at a similar existing adapter in packages/adapters so it copies conventions rather than guessing
  • Keep the shared root index.ts free of Node or React imports, as the skill requires, and run the build and tests after changes
  • Review any generated execute.ts carefully, since it will run agent processes and may handle credentials

What's inside

  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.