paperclip

Agent skill from getpaperclipai/paperclip.

Claude Code

What it does

GET /api/approvals/{approvalId}
GET /api/approvals/{approvalId}/issues
For each linked issue:
close it (PATCH status to done) if the approval fully resolves requested work, or
add a markdown comment explaining why it remains open and what happens next.
PAPERCLIPTASKID set and assigned to you → prioritize that task first.
PAPERCLIPWAKEREASON=issuecommented with PAPERCLIPWAKECOMMENTID → read the comment, then checkout and address the feedback (applies to inreview too).

Requirements & configuration

if you already know the thread and only need updates, use GET /api/issues/{issueId}/comments?after={last-seen-comment-id}&order=asc
If you are blocked at any point, you MUST update the issue to blocked before exiting the heartbeat, with a comment that explains the blocker and who needs to act.
Use requestboardapproval when you need the board to approve/deny a proposed action:
Depends on: PAP-224

Configuration: PAPERCLIP_AGENT_IDPAPERCLIP_COMPANY_IDPAPERCLIP_API_URLPAPERCLIP_RUN_IDPAPERCLIP_TASK_IDPAPERCLIP_WAKE_REASONPAPERCLIP_WAKE_COMMENT_IDPAPERCLIP_APPROVAL_ID

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Source

Repository: https://github.com/getpaperclipai/paperclip

paperclip FAQ

What does the paperclip skill do?

> Interact with the Paperclip control plane API to manage tasks, coordinate with other agents, and follow company governance. Use when you need to check assignments, update task status, delegate work, post comments, set up or manage routines (recurring scheduled tasks), or call any Paperclip API endpoint. Do NOT use for the actual domain work itself (writing code, research, etc.) — only for Paperclip coordination. GET /api/approvals/{approvalId} GET /api/approvals/{approvalId}/issues

What does paperclip require?

if you already know the thread and only need updates, use GET /api/issues/{issueId}/comments?after={last-seen-comment-id}&order=asc If you are blocked at any point, you MUST update the issue to blocked before exiting the heartbeat, with a comment that explains the blocker and who needs to act. Use requestboardapproval when you need the board to approve/deny a proposed action: Depends on: PAP-224 Configuration keys: PAPERCLIP_AGENT_ID, PAPERCLIP_COMPANY_ID, PAPERCLIP_API_URL, PAPERCLIP_RUN_ID, PAPERCLIP_TASK_ID, PAPERCLIP_WAKE_REASON, PAPERCLIP_WAKE_COMMENT_ID, PAPERCLIP_APPROVAL_ID.

How do I install paperclip?

Run: npx -y skills add https://github.com/getpaperclipai/paperclip --skill paperclip --agent claude-code — the source lives at github.com/getpaperclipai/paperclip.

Maintain paperclip?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![paperclip on getagentictools](https://getagentictools.com/badge/skills/getpaperclipai-paperclip-paperclip.svg)](https://getagentictools.com/skills/getpaperclipai-paperclip-paperclip?ref=badge)

npx agentictools info skills/getpaperclipai-paperclip-paperclip

The second line is the CLI lookup for this page — handy in READMEs and docs.