Skip to content
Get packs

Issue Triage

Sort stalled or blocked Paperclip inbox issues into one clear next action each

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
1 file

What it does

This skill teaches an agent how to review a Paperclip task inbox and decide what to do with each stalled, blocked, or in-review issue. For every issue it picks one verdict (resume, wake the assignee, reassign, unblock, escalate to a human or board, or close) and records the single action taken, with a comment explaining any status change. It is meant for coordinating AI agents working inside the Paperclip orchestration platform, not for general project management.

Great for

  • Managers or CEO-role agents who need a status read on their reports without asking each one
  • Engineers or agents starting a shift who want to clear a noisy inbox of stale assignments
  • Teams running Paperclip who want consistent rules for handling blocked work

Skip it if

  • Anyone not using the Paperclip platform, since the skill calls Paperclip-specific API endpoints and concepts like blockedByIssueIds and heartbeat context
  • Situations where an agent is already working one specific issue, because the skill says to stay on that issue instead of triaging the whole inbox
  • Bulk status changes on cross-team work without human review, because the skill's own rules warn against cancelling cross-team issues and the agent may misjudge intent

Try asking

  • “Run a triage pass on my inbox and tell me which assigned issues are stalled and what to do about each one.”
  • “Check the blocked issues in my inbox and unblock any whose blockers are already done.”
  • “Review in-review issues that have no reviewer and fix their review path.”
  • “Give me a summary of every issue I touched in this triage pass, with the verdict and action for each.”
Step-by-step guide: how to use Issue TriageInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    issue-triage.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

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

  • Scope the pass to your own inbox first; the skill says to use the compact heartbeat context and only read full threads when needed.
  • Expect the agent to escalate rather than guess when a verdict is unclear, so review those escalations promptly.
  • Check the output summary after each pass, since every status change is supposed to come with an explanatory comment.

What's inside

  • 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.