Skip to content
cccskills
FreePublished on GitHubEnglish overview

issue-triage

Review stalled, blocked, or pending-review issues in Paperclip and choose one concrete next action for each. Clarify ownership and status, then resume work, reassign it, resolve blockers, request a decision, or close the issue.

OriginalShow the original description

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

AI rating90/ 100See how to install

Good for

  • Reviewing active assignments at the start of a day or shift
  • Sorting an inbox with many open assignments
  • Checking team progress without asking every agent
  • Deciding what to do with an issue that has stalled

Overview

What it does

This skill reviews assigned issues in Paperclip and identifies each issue's owner, status, and one action needed to move it forward. It checks whether work is still running, needs a prompt to resume, requires a different owner, or has a blocker to resolve. It also handles requests for decisions and closing completed, duplicate, or unnecessary issues. Each reviewed issue gets a short summary of the decision and action taken.

When it helps

Use it for a morning progress review or when unfinished assignments make priorities unclear. Managers can check progress without asking every agent individually. It also helps when a comment flags an old issue as stalled. Reviews cover work without recent updates, reviews without a reviewer, and blocked issues whose dependencies are complete.

Example requests

  • “Review my assigned issues and choose one next action for each.”
  • “Check dependencies on stalled issues and identify what can resume.”
  • “Check whether issues awaiting review have suitable reviewers.”

Notes

The skill retrieves assignments and issue states through the Paperclip API. It excludes work already underway on a specific issue and questions awaiting user answers. Cross-team issues go to their responsible manager rather than being cancelled. Status changes require reasons. Issues that cannot be assessed quickly are referred for a decision instead of guessed at.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt specifies shift-start and stalled-work reviews and requires one next action per issue.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt specifies retrieval APIs, six verdicts, and output containing the issue ID, verdict, and action.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt requires reasons for status changes, prohibits cancelling cross-team issues, and escalates uncertain decisions.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingPaperclip retrieval APIs are specified, but connection and authentication setup steps are absent.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 20, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md3.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Issue Triage

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.

When to use

  • Daily or shift-start review of in_progress, in_review, and blocked assignments.
  • An inbox has many open assignments and no clear priority.
  • A manager wants a status read on their reports without asking each agent.
  • You are woken by a comment that suggests an old issue stalled.

When not to use

  • You are checked out on one specific issue and the wake context names it. Work that issue, do not triage the whole inbox.
  • An issue thread already has an open request_confirmation or ask_user_questions. Wait for the response — re-triage is noise.

Inputs

  • GET /api/agents/me/inbox-lite for the compact assignment list.
  • For each candidate issue, GET /api/issues/{issueId}/heartbeat-context for compact state including blockerAttention, executionState, ancestors, and commentCursor.
  • Only fall back to the full thread when the heartbeat context is not enough.

Per-issue triage decision

For each issue, classify into exactly one of:

  1. Resume — execution path is alive. Confirm the assignee is set and let the heartbeat continue. Do not comment.
  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.
  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.
  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.
  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.
  6. Close — work is complete, duplicate, or no longer relevant. Set done or cancelled with a one-line reason.

If you cannot classify in under a minute of reading, escalate rather than guess.

Stuck-state heuristics

  • in_progress with no comments or document updates in the last 24h and no monitor or queued continuation → wake-needed.
  • in_review with no reviewer participant, no pending interaction, no approval — invalid review path → reassign to a real reviewer or move to todo.
  • blocked with no blockedByIssueIds, only free-text "blocked by X" → convert to first-class blockers or move to todo with a named action.
  • blocked with all blockers done → unblock the issue by setting status back; the assignee will wake.
  • Child issues all complete but parent still in_progress → confirm parent acceptance, then close.

Don't-do list

  • Do not @-mention agents during triage; mentions cost budget. Use direct reassignment instead.
  • Do not re-comment on a blocked issue if your most recent comment was also a blocked update with no reply since.
  • Do not cancel cross-team issues. Reassign to the responsible manager with a comment.
  • Do not change status without a comment that explains the change.

Output of a triage pass

A short comment chain or summary message that lists, per issue touched:

  • Issue id and title.
  • Verdict (resume / wake-needed / reassign / unblock / escalate / close).
  • The one action you took or asked for.

This is the bar for "the triage is done."

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

add-product-e2e-eval

FreeSummaryAI rating 90

Add or extend Paperclip end-to-end evaluations that exercise real browser workflows across the server, database, and runner. Define expected outcomes, check independent evidence, and connect results to the existing reporting pipeline for local or Daytona execution.

  • Adding an evaluation for a complete user workflow
  • Updating test data and outcome checks
  • Including screenshots and artifacts in evaluation reports
paperclipai/paperclip105.9KUpdated Oct 22, 2026

add-runner-eval

FreeSummaryAI rating 90

Add or extend Paperclip Runner evaluations that test real sessions against a mock control service. Define observable pass conditions, validate cases and run selections, and retain source revisions, evidence, and costs for authorized live runs.

  • Adding a focused Runner protocol evaluation
  • Testing grading rules with valid and invalid evidence
  • Updating evaluation selections and campaign membership
paperclipai/paperclip105.9KUpdated Oct 22, 2026

agent-browser

FreeSummaryAI rating 90

Use a real browser to verify web pages and apps through short, supervised interactions. Capture screenshots, inspect errors and network requests, and document reproducible steps for UI bugs or expected behavior checks.

  • Capture screenshots to verify UI changes
  • Read content rendered by JavaScript
  • Reproduce UI bugs and record errors
paperclipai/paperclip105.9KUpdated Oct 22, 2026

agentmail

FreeSummaryAI rating 100

Read email linked to assigned Paperclip tasks, send new messages or replies through an assigned AgentMail inbox, and check delivery outcomes. Follow task permissions and preserve retry identifiers to avoid duplicate sends.

  • Reading email context attached to an assigned task
  • Sending a new email from an assigned inbox
  • Replying to a specific message in a conversation
paperclipai/paperclip105.9KUpdated Oct 22, 2026

check-pr

FreeSummaryAI rating 80

Inspect proposed changes in GitHub, GitLab, or Perforce for review feedback, failed automated checks, and incomplete descriptions. It separates actionable findings from informational or resolved comments, then helps fix issues and close addressed review threads when requested.

  • Inspect a change before submission
  • Identify failed checks and required fixes
  • Organize human and bot review feedback
paperclipai/paperclip105.9KUpdated Oct 22, 2026

company-creator

FreeSummaryAI rating 100

Create an AI agent company or team package from an idea or an existing repository. Define roles, reporting lines, skills, and work handoffs, then generate structured files that follow the Agent Companies specification.

  • Build an agent company from an idea
  • Turn a repository into an agent team package
  • Define agent roles and work handoffs
paperclipai/paperclip105.9KUpdated Oct 22, 2026

See all skills by paperclipai

Report a problem with this skill