# Create Runner Adapter

Adds a new harness or provider to the native runner, tested end to end.

- Repository: https://github.com/paperclipai/paperclip (109885 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add paperclipai/paperclip --skill create-runner-adapter -g -a claude-code -y`
Codex: `npx skills add paperclipai/paperclip --skill create-runner-adapter -g -a codex -y`
Cursor: `npx skills add paperclipai/paperclip --skill create-runner-adapter -g -a cursor -y`
Gemini CLI: `npx skills add paperclipai/paperclip --skill create-runner-adapter -g -a gemini-cli -y`

## Description

Add a new harness/provider integration to native Paperclip Runner, from requirements and protocol research through implementation, packaging, and real end-to-end acceptance. Use for new Runner adapters; legacy direct adapter authoring and migration are outside this skill.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Add a native Runner adapter

Use this skill to add a harness to the **new, native Paperclip Runner** execution
system. Here, adapter means the provider translation and launch integration
behind a Runner harness driver. Preserve existing direct adapters and historical
records as compatibility constraints; do not route this work through their
package-authoring recipe or migrate agents as a side effect.

The complete procedure is the [Runner integration playbook](../../../doc/RUNNER-INTEGRATION-PLAYBOOK.md).
Use its [working templates](../../../doc/runner-integration-templates.md) for the
release contract, capability inventory, acceptance ledger, and failure record.
These repository files contain the decision rules and test criteria themselves.
No private chat, task, prior campaign, or separate private repository is required.
Source links identify code to inspect, not evidence that a new integration passed.

If this skill was installed separately, locate the target checkout from the
current workspace or `git rev-parse --show-toplevel`. Verify it contains
`packages/paperclip-runner` and `tests/runner-e2e`; resolve `doc/` paths there.
Follow that checkout's `AGENTS.md` and scoped rules before editing.

## Work sequence

The rest: https://github.com/paperclipai/paperclip/blob/HEAD/.agents/skills/create-runner-adapter/SKILL.md