Agent skill · software engineering · paperclipai
create-agent-adapter
Create or modify Paperclip agent adapters across server, UI, and CLI surfaces. Use when adding support for a new CLI agent, API agent, custom process, or adapter package.
Why this skill is useful
Adds a complete implementation guide for creating Paperclip agent adapters, including executable code structures and interfaces that are not publicly documented.
What it needs
Requires typescript installed locally. About 10k tokens when loaded. Last updated 2026-08-07. 75,771 stars on the source repository.
What this skill does
Creating a Paperclip Agent Adapter An adapter bridges Paperclip's orchestration layer to a specific AI agent runtime (Claude Code, Codex CLI, a custom process, an HTTP endpoint, etc.). Each adapter is a self-contained package that provides implementations for three consumers: the server, the UI, and the CLI. --- 1. Architecture Overview Three separate registries consume adapter modules: Registry Location Interface ---------- ---------- ----------- Server server/src/adapters/registry.ts ServerAdapterModule UI ui/src/adapters/registry.ts UIAdapterModule CLI cli/src/adapters/registry.ts CLIAdapterModule --- 2. Shared Types (@paperclipai/adapter-utils) All adapter interfaces live in packages/adapter-utils/src/types.ts. Import from @paperclipai/adapter-utils (types) or @paperclipai/adapter-utils/server-utils (runtime helpers). Core Interfaces Module Interfaces --- 2.1 Adapter Environment Test Contract Every server adapter must implement testEnvironment(...). This powers the board UI "Test environment" button in agent configuration. Guidelines: Return structured diagnostics, never throw for expected findings. Use error for invalid/unusable runtime setup (bad cwd, missing command, invalid URL). Use warn for non-blocking but important situations. Use info for successful checks and context. Severity policy is product-critical: warnings are not save blockers. Example: for claudelocal, detected ANTHROPICAPIKEY must be a warn, not an error, because Claude can still run (it just uses API-key auth instead of subscription auth). --- 3. Step-by-Step: Creating a New Adapter 3.1 Create the Package package.json — must use the four-export convention: 3.2 Root index.ts — Adapter Metadata This file is imported by all three consumers (server, UI, CLI). Keep it dependency-free (no Node APIs, no React). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills paperclipai/create-agent-adapter