Skip to content

Create Paperclip Plugin

Scaffold, install and test an external Paperclip plugin using the paperclipai CLI.

Stars
110,078
Licence
MIT
Files
1 file

What it does

It gives the agent a step-by-step playbook for building a plugin (an add-on package) for Paperclip, a local AI agent platform. The agent scaffolds a new plugin folder outside the Paperclip code, installs it into a running Paperclip instance from a local path, rebuilds it while editing, and runs typecheck, test and build checks before reporting results with a standard checklist.

Great for

  • Developers extending a local Paperclip instance with custom plugins
  • Teams who want plugins kept separate from Paperclip core code and deployed as npm packages later

Skip it if

  • Non-developers who just want to use Paperclip, since it assumes CLI, pnpm and TypeScript knowledge
  • Changes that must be bundled into Paperclip core, which the skill says to avoid unless explicitly requested, because they touch shared server files

Try asking

  • “Create a new Paperclip plugin called @acme/my-plugin outside the repo and install it locally”
  • “Rebuild and reinstall my local plugin after I changed the manifest, then check its status with plugin list”
  • “Run typecheck, tests and build on my plugin and report the results in the success checklist format”
  • “Show me which capabilities my plugin manifest declares and whether any are unsupported”
Step-by-step guide: how to use Create Paperclip PluginInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    paperclip-create-plugin.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip paperclip-create-plugin.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip paperclip-create-plugin.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give an explicit absolute output path such as ~/dev/paperclip-plugins so the plugin is not created inside the Paperclip repo.
  • Ask for a bundled in-repo example only if you really want changes to Paperclip core files.
  • Expect manifest changes to need a reinstall; the server only auto-restarts the worker when built output in dist/ changes.

What's inside

  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.