issue-triage

Classifies stale, blocked, or stalled Paperclip inbox issues and assigns one next action per issue.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/adamtpang/summon.company --skill issue-triage-adamtpang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-triage
Source: https://github.com/adamtpang/summon.company/tree/main/packages/skills-catalog/catalog/bundled/paperclip-operations/issue-triage
Command: npx skills add https://github.com/adamtpang/summon.company --skill issue-triage-adamtpang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent-managed inboxes accumulate stale, blocked, and stalled issues with no clear owner or next step. This Skill turns a noisy Paperclip inbox into a short list of concrete actions, giving every touched issue a defined owner, status, and one action that moves it forward. ## Core Features & Use Cases - Six-way triage verdicts: Classifies each issue as resume, wake-needed, reassign, unblock, escalate, or close, with rules for when each applies. - Stuck-state heuristics: Detects stalled in_progress issues, invalid review paths, free-text blockers, resolved blockers, and completed child issues with open parents. - Budget-safe operation: Avoids @-mentions, redundant blocked comments, and status changes without explanatory comments. - Use Case: A manager starts a shift, runs a triage pass over all in_progress, in_review, and blocked assignments, and ends with a summary listing each issue's verdict and the single action taken. ## Quick Start Triage my Paperclip inbox and give me the verdict and next action for every stale, blocked, or in-review issue.

Frequently Asked Questions about issue-triage

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

FAQPage Schema
How do I triage a stalled agent inbox in Paperclip?

Fetch the compact assignment list from the inbox-lite endpoint, then pull heartbeat-context for each candidate issue. Classify each into one verdict (resume, wake-needed, reassign, unblock, escalate, or close) and record the single action taken per issue.

How to detect stalled in_progress issues assigned to AI agents?

An in_progress issue with no comments or document updates in the last 24 hours and no monitor or queued continuation is considered stalled. Post one comment naming the blocker resolution or exact next action so the assignee wakes and resumes.

When should I not run an inbox triage pass?

Skip triage when you are checked out on one specific issue named in the wake context, or when a thread already has an open request_confirmation or ask_user_questions. Re-triaging while waiting for a response only adds noise.

How do I unblock a Paperclip issue with resolved blockers?

When all entries in blockedByIssueIds are done, set the issue status back so the assignee wakes automatically. If a blocker was cancelled, replace or remove it from blockedByIssueIds rather than leaving the stale reference.

Why avoid @-mentioning agents during issue triage?

Mentions cost budget each time they trigger an agent wake. Use direct reassignment or a plain status comment instead, which conveys the same information without spending agent execution budget.