create-agent-adapter

Define Paperclip agent adapter packages with required exports and registration conventions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/windingriverholdings/paperclip --skill create-agent-adapter-windingriverholdings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-agent-adapter
Source: https://github.com/windingriverholdings/paperclip/tree/main/.agents/skills/create-agent-adapter
Command: npx skills add https://github.com/windingriverholdings/paperclip --skill create-agent-adapter-windingriverholdings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a blueprint for creating a new Paperclip agent adapter package that connects the orchestration layer to a specific runtime (server, UI, and CLI), ensuring a consistent structure, registration points, and conventions.

Core Features & Use Cases

  • Defines the required exports (type, label, models, agentConfigurationDoc) and the four-export package layout that powers server, UI, and CLI integrations.
  • Describes the end-to-end adapter lifecycle: environment setup, session management, prompt rendering, process spawning, stdout parsing, and metadata emission for runtime artifacts.
  • Outlines practical use cases such as adding support for a new AI coding tool, integrating a custom process, or extending an existing adapter family while preserving compatibility with claude-local and codex-local patterns.

Quick Start

Create a new adapter package under packages/adapters following the provided skeleton and implement server, UI, and CLI modules.

Frequently Asked Questions about create-agent-adapter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Paperclip adapter for a new AI agent runtime?

To build a Paperclip adapter, create a new package under packages/adapters following the four-export layout that provides server, UI, and CLI integrations. You must define required exports including type, label, models, and agentConfigurationDoc to establish the connection.

What is the required module structure for a Paperclip agent adapter?

The required module structure for a Paperclip agent adapter consists of a four-export package layout powering server, UI, and CLI integrations. This structure must wire environment setup, session management, prompt rendering, process spawning, and stdout parsing into the registry.

Does my custom adapter need to match claude-local and codex-local conventions?

Yes, your custom adapter should preserve compatibility with claude-local and codex-local patterns. The blueprint outlines specific registration conventions and required exports that ensure your new runtime integrates consistently with the existing orchestration layer.

How do I wire session management and prompt rendering into an agent adapter?

You wire session management and prompt rendering by implementing the end-to-end adapter lifecycle modules. This lifecycle covers environment setup, session management, prompt rendering, process spawning, stdout parsing, and metadata emission for runtime artifacts.

Can I use this adapter pattern to integrate a custom process into the orchestration layer?

Yes, you can integrate a custom process by creating a new adapter package that follows the provided skeleton. The pattern supports adding support for a new AI coding tool, integrating a custom process, or extending an existing adapter family.

What are the limitations when extending an existing Paperclip adapter family?

When extending an existing Paperclip adapter family, you must preserve compatibility with established claude-local and codex-local patterns. Deviating from the required exports, module structure, and registration conventions will break the orchestration layer.