create-agent-adapter

Create Paperclip adapter skeletons with server, UI, and CLI exports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a complete blueprint for engineers to build a Paperclip agent adapter, ensuring a consistent interface across the server, UI, and CLI layers so new runtimes can be integrated with minimal friction.

Core Features & Use Cases

  • Defines a minimal adapter package with four exports (server, UI, CLI, and root index).
  • Enforces the adapter contract: type, label, models, and agentConfigurationDoc to enable discovery and configuration.
  • Includes registration guidance and security considerations to safely connect new runtimes to Paperclip.

Quick Start

Create a new adapter package under packages/adapters, implement the root index.ts exports, wire up server/UI/CLI modules, and register the adapter in the adapters registries for server, UI, and CLI.

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 to integrate an external agent runtime?

To build a Paperclip adapter, create a package under packages/adapters, implement the root index.ts exports, wire up server, UI, and CLI modules, and register the adapter in the respective registries to connect the external agent runtime.

What is the required contract for a Paperclip agent adapter?

A Paperclip agent adapter contract requires defining the adapter type, label, models, and agentConfigurationDoc to enable runtime discovery and configuration across server, UI, and CLI orchestration layers.

How do I structure modules when creating an adapter for Paperclip?

When creating an adapter for Paperclip, structure the package with four exports: the root index.ts, server module, UI module, and CLI module, ensuring strict frontmatter exports and type definitions are maintained.

Can I update an existing Paperclip adapter instead of building one from scratch?

Yes, you can update an existing Paperclip adapter by modifying its server, UI, and CLI components, ensuring type definitions, session handling, and safe environment injection still meet the orchestration layer's adapter contract.

Why do I need safe environment injection and session handling in a Paperclip adapter?

Safe environment injection and session handling are required in a Paperclip adapter to ensure reliable, restartable agent runs when wrapping an external agent runtime into the orchestration layer.

What are the limitations when integrating a new agent runtime with Paperclip?

Integrating a new agent runtime with Paperclip requires strict adherence to frontmatter exports, type definitions, and registration points across server, UI, and CLI layers, meaning runtimes bypassing these conventions cannot be reliably orchestrated.