Agent skill · software engineering · paperclipai
paperclip-task-bridge
Create, comment on, update, and list Paperclip tasks from Hermes using scoped Paperclip API credentials.
Why this skill is useful
Adds executable scripts for creating, updating, and managing tasks in Paperclip that aren't covered in public documentation.
What it needs
Requires node installed locally. Requires paperclip account access. About 2k tokens when loaded. Last updated 2026-08-07. 75,771 stars on the source repository.
What this skill does
Paperclip Task Bridge Use this skill when a Hermes-originated request needs to create or update Paperclip work directly. This is the Hermes-to-Paperclip direction, separate from Paperclip waking Hermes through the hermeslocal or hermesgateway adapter. Required Environment Configure these in Hermes env/profile secrets, not in prompt text: PAPERCLIPAPIURL - Paperclip base URL, with or without /api. PAPERCLIPBRIDGEAPIKEY - a Paperclip agent API key created with scope.kind = "taskbridge". Optional: PAPERCLIPAPIKEY - fallback env var for older profiles; it must still contain a taskbridge scoped key, never a full agent key. PAPERCLIPCOMPANYID - skips one identity lookup when set. PAPERCLIPAGENTID - skips one identity lookup when set. PAPERCLIPRUNID - sent as X-Paperclip-Run-Id on mutating requests when Hermes is running inside a Paperclip heartbeat. Never print or paste API keys. The helper reads credentials from environment variables and only prints response summaries. Do not put a normal claimed agent API key in an internet-facing Hermes runtime; normal keys can use broad same-company Paperclip routes. Create a Bridge Key Create the key from a board-authenticated Paperclip API session and store the returned token once: Use parentIssueId or parentIssueIds when Hermes should only create child tasks under approved work. Use projectId or projectIds when the approved boundary is a project. A bridge key can create tasks only inside that boundary, can comment/update only bridge-created or assigned issues, and cannot use company-wide issue list/search/read surfaces. Helper Run the helper from this skill directory: Commands: create-task defaults to assigning the task to the authenticated Hermes agent so the work is immediately actionable. Use --unassigned to create backlog work instead. Use --assignee-agent-id <uuid> only when the Paperclip API key has permission to assign work to that agent. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills paperclipai/paperclip-task-bridge