Paperclip Create Plugin

This walks you through the CLI-first workflow for building Paperclip plugins outside the core repo. It covers scaffolding with `paperclipai plugin init`, installing by local path, and the watch-rebuild loop where Paperclip auto-restarts your worker on file changes. The skill is opinionated about keeping plugins as separate packages and includes a verification checklist (typecheck, test, build) to run before you call it done. One thing to know upfront: the current runtime treats plugin code as trusted and same-origin, so there's no sandboxing yet. If you're adding custom functionality to a Paperclip instance or prototyping a connector, this gives you the exact commands and gotchas.

skills.sh installs: 3.1K
GitHub stars: 112.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add paperclipai/paperclip --skill paperclip-create-plugin --agent claude-code

Installs into .claude/skills of the current project.

Files

Create and develop a Paperclip plugin

Use this skill when the task is to create, scaffold, or iterate on a Paperclip plugin against a local Paperclip instance.

1. Default: build the plugin OUTSIDE Paperclip core

Plugins are their own packages. Unless the task explicitly asks for a bundled in-repo example, do not add plugin source under packages/plugins/ in this repo.

Scaffold the plugin into a directory outside the Paperclip checkout (e.g. ~/dev/paperclip-plugins/<name>).
Install it into the running Paperclip instance by local absolute path.
Edit code in the external package; let Paperclip pick up rebuilt output.

Only edit Paperclip core itself when the user asks to surface a plugin as a bundled example (server/src/routes/plugins.ts, in-repo example lists, docs).