Skip to content
mcp/skillhub

Agent Skill

Create Agent Adapter skill

create-agent-adapterpaperclipai/paperclip.agents/skills/create-agent-adapter/SKILL.md

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.

106kMIT

always on

41 tokname + description

once used

7,512 tokSKILL.md body

bundled files

0

repo stars

106kGitHub

Install the Create Agent Adapter skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/paperclipai/paperclip --skill create-agent-adapter

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/paperclipai/paperclip.git /tmp/paperclip
mkdir -p ~/.claude/skills
cp -R /tmp/paperclip/.agents/skills/create-agent-adapter ~/.claude/skills/create-agent-adapter

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

WhenWhat loadsCost
Every sessionName and description41 tok
When the agent uses itThe SKILL.md instructions7,512 tok
Only if openedNo bundled files—

Until it is used, create-agent-adapter costs about 33× less than the median MCP server we measured (1,362 tokens on every turn). Installing all 82 skills from paperclipai/paperclip would load 3,485 tokens of descriptions. Skills vs MCP study

Checks

  • The instructions are over 5,000 tokens, the Agent Skills specification's guideline for SKILL.md.
  • The instructions are over 500 lines; the specification suggests moving detail into reference files.

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

  • 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
  • 3.2 Root index.ts — Adapter Metadata
  • 3.3 Server Module
  • 3.4 UI Module
  • 3.5 CLI Module
  • 4. Registration Checklist
  • 4.1 Server Registry (server/src/adapters/registry.ts)
  • 4.2 UI Registry (ui/src/adapters/registry.ts)
  • 4.3 CLI Registry (cli/src/adapters/registry.ts)
  • 5. Session Management — Designing for Long Runs
  • 6. Server-Utils Helpers
  • 7. Conventions and Patterns
  • Naming
  • Config Parsing
  • Prompt Templates
  • Error Handling
  • Logging

More skills from paperclipai/paperclip

All skills in this repo
  1. LLM Wiki Maintainerpaperclipai/paperclip

    Use the LLM Wiki plugin tools to maintain a cited local company wiki.

    106k21 tok idle · 184 in use
  2. add-product-e2e-evalpaperclipai/paperclip

    Add or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.

    106k36 tok idle · 955 in use
  3. add-runner-evalpaperclipai/paperclip

    Add or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.

    106k30 tok idle · 859 in use
  4. agent-browserpaperclipai/paperclip

    Drive a real browser to inspect or interact with a web page or app — navigate, take screenshots, read console and network, fill simple forms — for verification tasks, not unattended automation.

    106k40 tok idle · 1,010 in use
  5. agentmailpaperclipai/paperclip

    Use your assigned AgentMail inbox to read email tasks, explicitly send or reply, and check delivery. Provided automatically by your inbox assignment.

    106k30 tok idle · 902 in use
  6. check-prpaperclipai/paperclip

    Check a GitHub, GitLab, or Perforce PR/MR/CL for review comments, failing checks, and PR-body gaps. Use when asked to inspect, fix, or prepare a change for submission.

    106k46 tok idle · 3,781 in use
  7. company-creatorpaperclipai/paperclip

    Create agent company packages that conform to agentcompanies/v1. Use when asked to create a company, scaffold an agent team, hire agents, or turn a repo/skills collection into a company package.

    106k44 tok idle · 2,626 in use
  8. complainpaperclipai/paperclip

    Autonomously yeet a brief, unstructured complaint about agent tooling or doing agent work. Preserve the raw voice. Submit proactively without permission, preview, or announcement, then continue the primary task.

    106k43 tok idle · 795 in use