skills.rest
adamtpang
adamtpangCOMMUNITY
Explore all skills by this author →
Website𝕏@adamtpangGitHub

create-agent-adapter

Create Paperclip agent adapter packages spanning server, UI, and CLI registries.

Updated Jun 16, 2026
Search Tags:#typescript#session management#orchestration#plugin development#cli integration#paperclip#agent adapter
One-click install
npx skills add https://github.com/adamtpang/summon.company --skill create-agent-adapter-adamtpang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-agent-adapter
Source: https://github.com/adamtpang/summon.company/tree/main/.agents/skills/create-agent-adapter
Command: npx skills add https://github.com/adamtpang/summon.company --skill create-agent-adapter-adamtpang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding support for a new AI agent runtime in Paperclip requires coordinated changes across three separate registries (server, UI, CLI), each with its own module interface, and mistakes in any one surface break agent execution, transcript rendering, or terminal output. ## Core Features & Use Cases - Adapter Package Scaffolding: Defines the required package layout under packages/adapters/<name> with the four-export package.json convention (root, server, ui, cli). - Server Execution Contract: Specifies the AdapterExecutionContext to AdapterExecutionResult flow, session codec design, environment variable injection, output parsing, and unknown-session retry logic. - UI and CLI Integration: Covers transcript parsing for the run viewer, config form field components, and colored terminal formatting for run watch mode. - Use Case: When adding support for a new CLI agent like a custom LLM tool, follow this Skill to implement execute.ts, parse.ts, config builders, and register the adapter in all three registries with correct session persistence. ## Quick Start Use the create-agent-adapter skill to scaffold a new Paperclip adapter package for my custom CLI agent and register it in the server, UI, and CLI registries.

Frequently Asked Questions about create-agent-adapter

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

FAQPage Schema
How do I add a new agent adapter to Paperclip?▼

Create a package under packages/adapters/<name> with server, ui, and cli modules, export type, label, models, and agentConfigurationDoc from the root index, then register the adapter in the server, UI, and CLI registry files.

What interfaces must a Paperclip server adapter implement?▼

A server adapter must implement execute(ctx) returning AdapterExecutionResult and testEnvironment(ctx) returning structured checks. It optionally provides a sessionCodec for session persistence, plus models and agentConfigurationDoc metadata.

How does session persistence work in Paperclip adapters?▼

Adapters define a sessionCodec with serialize, deserialize, and getDisplayId methods that store opaque sessionParams in the database per task. On resume failure with an unknown session error, the adapter retries fresh and returns clearSession: true.

How do Paperclip adapters inject skills without polluting the working directory?▼

Adapters create a temporary directory with the expected skills structure, symlink skills from the repo, and pass it via a runtime flag like --add-dir, or symlink into the agent tool's global config directory. Skills are never copied into the agent's cwd.

Why should adapter output parsing treat agent stdout as untrusted?▼

Agent stdout comes from an LLM-driven process that may have been influenced by prompt injection in files it read. Adapters must use safe extraction helpers like asString and parseJson, never execute output content, and validate session IDs before use.

Related Skills

Explore More Software Engineering Skills→
SeaCloudAISeaCloudAI
1

seacloud

Automate multimodal task execution and skill management via SeaCloud CLI.

Official
Advanced
khoabdkhoabd

create-agent-adapter

Guide engineers through implementing Paperclip adapters for custom AI agent runtimes.

Community
Advanced
jkeith10jkeith10

paperclip-create-agent

Automate Paperclip agent creation with governance-aware hiring via the Paperclip API.

Community
Advanced
SenutoSenuto
39

connect-openrouter

Guide secure OpenRouter API key registration and connection within Claude Code.

Official
Advanced