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.
Target: Software development & testing. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Creating a Paperclip Agent Adapter
- 1. Architecture Overview
- 2. Shared Types (@paperclipai/adapter-utils)
- Core Interfaces
- Module Interfaces
- 2.1 Adapter Environment Test Contract
- 3. Step-by-Step: Creating a New Adapter
- 3.1 Create the Package
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. -- 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 | -- 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). -- 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: warnin
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- paperclipai/paperclip
- Source file
- .agents/skills/create-agent-adapter/SKILL.md
- Fixed revision
- 1ca3e8ea2a759e511ab2d2659339c6c770a7a2ba
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: paperclipai/paperclip · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-10T02:01:27.103Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.