skills.rest
telegraphic-dev
telegraphic-devOFFICIAL
Explore all skills by this author →
Website𝕏@telegraphic_devGitHub

paperclip

Drive Paperclip control plane APIs for task selection, checkout, and status updates.

Updated Mar 17, 2026
Search Tags:#task management#agent orchestration#status updates#api integration#governance approvals#heartbeat execution#issue checkout
One-click install
npx skills add https://github.com/telegraphic-dev/paperclip-deploy --skill paperclip-telegraphic-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paperclip
Source: https://github.com/telegraphic-dev/paperclip-deploy/tree/main/skills/paperclip
Command: npx skills add https://github.com/telegraphic-dev/paperclip-deploy --skill paperclip-telegraphic-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of keeping AI agents aligned with Paperclip’s task lifecycle, approvals, and audit requirements so your team can reliably coordinate work without manual status wrangling.

Core Features & Use Cases

  • Heartbeat orchestration for agent coordination: Wake up in heartbeats, pull assignments, checkout tasks, and update status with required run traceability.
  • Approval and comment-driven workflow: Follow up on approvals, link outcomes back to issues, and communicate progress or blockers via consistent markdown comments.
  • Task execution safety and governance guardrails: Avoid unsafe state transitions (never PATCH to in_progress), handle 409 conflicts correctly, deduplicate blocked-task re-posting, and escalate via chain of command when stuck.

Quick Start

Use the paperclip skill when your agent receives a Paperclip heartbeat context and you need to pick an assigned task, checkout the issue, read heartbeat context/comments, then update the issue status and post an auditable comment.

Frequently Asked Questions about paperclip

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate AI agent task execution with governance approvals?▼

Agent status updates are managed by driving Paperclip control plane APIs to update issue status and post auditable markdown comments, applying mandatory X-Paperclip-Run-Id headers on mutating requests for run traceability.

How do I prevent unsafe state transitions when checking out tasks via an agent orchestration API?▼

To start agent orchestration, your agent receives a Paperclip heartbeat context, picks an assigned task, checks out the issue, reads heartbeat context and comments, then updates the issue status and posts an auditable comment.

Do I need an API key to authenticate AI agent heartbeat execution for task management?▼

AI agent heartbeat execution requires Bearer authentication via an injected PAPERCLIP_API_KEY environment variable to authorize task selection, checkout, and status updates across company projects and goals.

What happens when an agent encounters a 409 conflict during task checkout?▼

When an agent encounters a 409 conflict during task checkout, it must handle the conflict correctly by avoiding unsafe state transitions, deduplicating blocked-task re-posting, and escalating via chain of command if it remains stuck.

Related Skills

Explore More Software Engineering Skills→
kmshihab7878kmshihab7878
6

paperclip

Manage Paperclip control plane tasks and coordinate agent assignments via JSON endpoints.

Community
Advanced
lobehublobehub
81.4k

linear

Automate Linear issue status updates and completion comments via MCP tools.

Official
Advanced
bychrisrbychrisr

paperclip

Orchestrate AI agent workflows via the Paperclip control plane API.

Community
Advanced
az9713az9713
2

paperclip

Manage tasks and coordinate agents via the Paperclip control plane API.

Community
Advanced