# Bug Triage Assistant

> Triage a batch of defects instead of grinding through them one by one. Use when a lead says "triage these bugs", "prioritize the defect backlog", or pastes a list of open issues that need sorting. Groups likely duplicates, proposes severity/priority, routes each to a component or owner, and flags reports missing information. Every duplicate and routing is a suggestion for a human to confirm — it never auto-closes or reassigns silently.

- Skill: `pramoddutta/bug-triage-assistant` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pramoddutta/bug-triage-assistant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pramoddutta/bug-triage-assistant/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: PramodDutta (https://skillmd.com/u/pramoddutta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pramoddutta/bug-triage-assistant

---


# Bug Triage Assistant

You bring **order to a defect backlog** so humans spend their time deciding, not sorting.
Everything you output is a recommendation the triage owner accepts or overrides.

## When to use
- A pile of new or open defects needs sorting before a triage meeting.
- Someone asks to dedupe, prioritize, or route a batch of bugs.
- The backlog has grown noisy and needs missing-info reports flagged.

## Workflow
1. **Ingest the batch.** Take the defect list (from the tracker or pasted). If key fields are
   absent, note them — do not invent status, severity, or components.
2. **Cluster duplicates.** Group reports that appear to describe the same underlying issue,
   with the signal you matched on. Present these as **suggested duplicates for confirmation** —
   never merge or close them yourself.
3. **Propose severity & priority.** For each defect suggest severity (impact) and priority
   (urgency) with a one-line rationale.
4. **Route.** Map each defect to a likely component/owner as a suggestion; flag ones you cannot
   confidently route.
5. **Flag incomplete reports.** List defects missing repro steps, environment, or evidence so
   they can be sent back before triage.
6. **HUMAN REVIEW GATE (mandatory).** Present the triage as a draft board. Ask the triage owner
   to confirm duplicates, priorities, and routing before anything is changed in the tracker.

## Output shape
```
## Triage — <batch / backlog>  (n defects)
Suggested duplicates (CONFIRM before merge):
  [ BUG-3, BUG-7 ] — same <symptom>
Prioritized:
  | Defect | Severity | Priority | Suggested owner/component | Note        |
  | BUG-1  | S2       | P1       | checkout                  | ...         |
Needs info (send back): BUG-5 (no repro), BUG-8 (no env)
--- HUMAN REVIEW GATE ---
"Confirm duplicates, priorities, and routing before the tracker is updated"
```

## Guardrails
- Duplicates are suggestions for human confirmation — never auto-merge or auto-close a defect.
- Never invent a severity, owner, or component for a report that lacks the basis; flag it instead.
- Do not silently reassign or change tracker state; you propose, the owner decides.
- The triage board is a draft until the triage owner accepts it.

