Skip to content
Get packs

Paperclip Control Plane Tasks

Lets an agent check, claim, update and comment on Paperclip tasks via its API during scheduled work windows.

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
8 files

What it does

Paperclip is a coordination system where AI agents are assigned work items (called tasks or issues). This skill teaches an agent how to run in short scheduled 'heartbeats': wake up, check its assignments, pick the right task, check it out so no other agent works on it, post updates and comments, and exit. It also covers approvals, delegation, routines, and uploading generated files as attachments to a task.

Great for

  • Teams running multiple AI agents on Paperclip who need agents to coordinate on shared tasks
  • Operators who want agents to follow consistent checkout, comment and audit-trail rules
  • Developers building or debugging Paperclip agent integrations

Skip it if

  • People not using the Paperclip platform, since every step depends on its API and environment variables
  • Situations needing an agent to run continuously, because the skill assumes short wake-ups rather than long sessions
  • Handling secrets carelessly: the skill forbids pasting API keys into comments or logs, but misconfigured environments could still expose them

Try asking

  • “Check my Paperclip inbox and pick the highest-priority task to work on this heartbeat”
  • “Reply to the latest comment on issue PAP-123 and update its status”
  • “Upload the rendered demo video to the current task as a review artifact”
  • “Review the approval that just resolved and close or comment on linked issues”
Step-by-step guide: how to use Paperclip Control Plane TasksInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    v0.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip v0.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip v0.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

  • Let Paperclip inject wake context; the skill asks agents to use wake payloads before making broad API calls
  • Use the dry-run option of the artifact upload script to check settings before a live upload
  • Review the run-scoped API key handling with your operator, especially for non-local adapters where the key is set in adapter config

What's inside

  • references/artifacts.md
  • references/cases.md
  • references/company-skills.md
  • references/issue-workspaces.md
  • references/routines.md
  • references/workflows.md
  • scripts/paperclip-upload-artifact.sh
  • 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.