issue-triage

Name: issue-triage
Author: getpaperclipai

5stars1forks

How to install issue-triage?

getpaperclipai/paperclip/issue-triage

$npx -y skills add getpaperclipai/paperclip --skill issue-triage

Installs into the current project.

Summary

Triage Paperclip inbox issues that are stale, blocked, in-review, or assigned-but-not-progressing, and decide a single next action per issue (resume, reassign, unblock, escalate, or close).

Files · 1

View on GitHub

SKILL.md

1	# Issue Triage
2
3	Convert a noisy inbox into a small set of clear next actions. Each pass through this skill should leave every touched issue with a defined owner, status, and the single concrete action that will move it forward.
4
5	## When to use
6
7	- Daily or shift-start review of `in_progress`, `in_review`, and `blocked` assignments.
8	- An inbox has many open assignments and no clear priority.
9	- A manager wants a status read on their reports without asking each agent.
10	- You are woken by a comment that suggests an old issue stalled.
11
12	## When not to use
13
14	- You are checked out on one specific issue and the wake context names it. Work that issue, do not triage the whole inbox.
15	- An issue thread already has an open `request_confirmation` or `ask_user_questions`. Wait for the response — re-triage is noise.
16
17	## Inputs
18
19	- `GET /api/agents/me/inbox-lite` for the compact assignment list.
20	- For each candidate issue, `GET /api/issues/{issueId}/heartbeat-context` for compact state including `blockerAttention`, `executionState`, ancestors, and `commentCursor`.
21	- Only fall back to the full thread when the heartbeat context is not enough.
22
23	## Per-issue triage decision
24
25	For each issue, classify into exactly one of:
26
27	1. Resume — execution path is alive. Confirm the assignee is set and let the heartbeat continue. Do not comment.
28	2. Wake-needed — assignee is stalled with no live continuation. Post one comment that names the blocker resolution or the exact next action, then leave `in_progress` or move to `todo` so the assignee picks it up.
29	3. Reassign — the assignee is not the right specialty. Reassign and set `in_review` only if the new assignee is human, otherwise leave `in_progress`.
30	4. Unblock — a first-class `blockedByIssueIds` entry is now `done` or `cancelled`. If `cancelled`, replace or remove it from `blockedByIssueIds`. The blockers-resolved wake will fire automatically when all are `done`.
31	5. Escalate — the issue needs board, CTO, or user input. Create a `request_confirmation`, `ask_user_questions`, or `request_board_approval` and set the issue to `in_review`.
32	6. Close — work is complete, duplicate, or no longer relevant. Set `done` or `cancelled` with a one-line reason.
33
34	If you cannot classify in under a minute of reading, escalate rather than guess.
35
36	## Stuck-state heuristics
37
38	- `in_progress` with no comments or document updates in the last 24h and no monitor or queued continuation → wake-needed.
39	- `in_review` with no reviewer participant, no pending interaction, no approval — invalid review path → reassign to a real reviewer or move to `todo`.
40	- `blocked` with no `blockedByIssueIds`, only free-text "blocked by X" → convert to first-class blockers or move to `todo` with a named action.
41	- `blocked` with all blockers `done` → unblock the issue by setting status back; the assignee will wake.
42	- Child issues all complete but parent still `in_progress` → confirm parent acceptance, then close.
43
44	## Don't-do list
45
46	- Do not @-mention agents during triage; mentions cost budget. Use direct reassignment instead.
47	- Do not re-comment on a `blocked` issue if your most recent comment was also a blocked update with no reply since.
48	- Do not cancel cross-team issues. Reassign to the responsible manager with a comment.
49	- Do not change status without a comment that explains the change.
50
51	## Output of a triage pass
52
53	A short comment chain or summary message that lists, per issue touched:
54
55	- Issue id and title.
56	- Verdict (resume / wake-needed / reassign / unblock / escalate / close).
57	- The one action you took or asked for.
58
59	This is the bar for "the triage is done."

People who liked this also viewed

6 picks

Type

issue-triage

5stars1forks

View on GitHub

How to install issue-triage?

getpaperclipai/paperclip/issue-triage

$npx -y skills add getpaperclipai/paperclip --skill issue-triage

Installs into the current project.

Summary

Triage Paperclip inbox issues that are stale, blocked, in-review, or assigned-but-not-progressing, and decide a single next action per issue (resume, reassign, unblock, escalate, or close).

Files · 1

View on GitHub

SKILL.md

1	# Issue Triage
2
3	Convert a noisy inbox into a small set of clear next actions. Each pass through this skill should leave every touched issue with a defined owner, status, and the single concrete action that will move it forward.
4
5	## When to use
6
7	- Daily or shift-start review of `in_progress`, `in_review`, and `blocked` assignments.
8	- An inbox has many open assignments and no clear priority.
9	- A manager wants a status read on their reports without asking each agent.
10	- You are woken by a comment that suggests an old issue stalled.
11
12	## When not to use
13
14	- You are checked out on one specific issue and the wake context names it. Work that issue, do not triage the whole inbox.
15	- An issue thread already has an open `request_confirmation` or `ask_user_questions`. Wait for the response — re-triage is noise.
16
17	## Inputs
18
19	- `GET /api/agents/me/inbox-lite` for the compact assignment list.
20	- For each candidate issue, `GET /api/issues/{issueId}/heartbeat-context` for compact state including `blockerAttention`, `executionState`, ancestors, and `commentCursor`.
21	- Only fall back to the full thread when the heartbeat context is not enough.
22
23	## Per-issue triage decision
24
25	For each issue, classify into exactly one of:
26
27	1. Resume — execution path is alive. Confirm the assignee is set and let the heartbeat continue. Do not comment.
28	2. Wake-needed — assignee is stalled with no live continuation. Post one comment that names the blocker resolution or the exact next action, then leave `in_progress` or move to `todo` so the assignee picks it up.
29	3. Reassign — the assignee is not the right specialty. Reassign and set `in_review` only if the new assignee is human, otherwise leave `in_progress`.
30	4. Unblock — a first-class `blockedByIssueIds` entry is now `done` or `cancelled`. If `cancelled`, replace or remove it from `blockedByIssueIds`. The blockers-resolved wake will fire automatically when all are `done`.
31	5. Escalate — the issue needs board, CTO, or user input. Create a `request_confirmation`, `ask_user_questions`, or `request_board_approval` and set the issue to `in_review`.
32	6. Close — work is complete, duplicate, or no longer relevant. Set `done` or `cancelled` with a one-line reason.
33
34	If you cannot classify in under a minute of reading, escalate rather than guess.
35
36	## Stuck-state heuristics
37
38	- `in_progress` with no comments or document updates in the last 24h and no monitor or queued continuation → wake-needed.
39	- `in_review` with no reviewer participant, no pending interaction, no approval — invalid review path → reassign to a real reviewer or move to `todo`.
40	- `blocked` with no `blockedByIssueIds`, only free-text "blocked by X" → convert to first-class blockers or move to `todo` with a named action.
41	- `blocked` with all blockers `done` → unblock the issue by setting status back; the assignee will wake.
42	- Child issues all complete but parent still `in_progress` → confirm parent acceptance, then close.
43
44	## Don't-do list
45
46	- Do not @-mention agents during triage; mentions cost budget. Use direct reassignment instead.
47	- Do not re-comment on a `blocked` issue if your most recent comment was also a blocked update with no reply since.
48	- Do not cancel cross-team issues. Reassign to the responsible manager with a comment.
49	- Do not change status without a comment that explains the change.
50
51	## Output of a triage pass
52
53	A short comment chain or summary message that lists, per issue touched:
54
55	- Issue id and title.
56	- Verdict (resume / wake-needed / reassign / unblock / escalate / close).
57	- The one action you took or asked for.
58
59	This is the bar for "the triage is done."

People who liked this also viewed

6 picks

Type