# Adapter Development

> Build a Paperclip extension — a plugin via @paperclipai/plugin-sdk or a built-in adapter under packages/adapters. Use when adding AI runtimes or feature plugins.

- Skill: `thebeardedbearsas/adapter-development-2` (Agent Skill)
- Install (CLI): `npx get-skill add thebeardedbearsas/adapter-development-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thebeardedbearsas/adapter-development-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: TheBeardedBearSAS (https://skillmd.com/u/thebeardedbearsas)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/thebeardedbearsas/adapter-development-2

---


# Paperclip Extension Development

Two surfaces: **adapters** (AI runtimes, `packages/adapters/<name>/`, export `type/label/models/agentConfigurationDoc`) and **plugins** (features, `@paperclipai/plugin-sdk`, `definePlugin({setup(ctx)})`). Adapters and plugins never hold governance state — the server enforces budgets, approvals, and tenancy.

See ../../rules/12-adapter-protocol.md for the full contract and examples.

