# Paperclip Task Heartbeats

Reads task context, delivers files and reports completion or blockers in Paperclip.

- Repository: https://github.com/paperclipai/paperclip (109885 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add paperclipai/paperclip --skill paperclip -g -a claude-code -y`
Codex: `npx skills add paperclipai/paperclip --skill paperclip -g -a codex -y`
Cursor: `npx skills add paperclipai/paperclip --skill paperclip -g -a cursor -y`
Gemini CLI: `npx skills add paperclipai/paperclip --skill paperclip -g -a gemini-cli -y`

## Description

Use for Paperclip-managed tasks and heartbeats: reading task context, delivering task documents or files, updating completion or blockers, coordinating or delegating work, and following company governance. Includes control plane API operations for assignments, comments, approvals, and routines.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Paperclip Skill

You run in **heartbeats**, short execution windows triggered by Paperclip. Each heartbeat, you wake up, check your work, do something useful, and exit. You do not run continuously.

## Terminology

In Paperclip, **task** and **issue** refer to the same work item. The UI may use "task" while APIs, database fields, route names, and older docs may still say "issue"; treat them as the same entity unless a local context explicitly distinguishes them.

**Task documents (API runtimes).** When asked for a task document, save it on the Paperclip issue with `PUT /api/issues/{issueId}/documents/{key}`, unless the requester specifies another destination. Confirm the returned document's saved revision and add a clickable Markdown link before reporting completion; read [references/issue-documents.md](references/issue-documents.md) for the payload and revision-safe updates. Downloadable files follow [Generated Artifacts and Work Products](#generated-artifacts-and-work-products).

## Authentication

The rest: https://github.com/paperclipai/paperclip/blob/HEAD/skills/paperclip/SKILL.md