Bug Triage Claude Skill Template

Who this is for

Engineering managers, support engineers, full-stack developers

What you can do with it

• ✓Triage incoming bug reports from Sentry or Linear
• ✓Classify bugs by severity and component
• ✓Generate reproduction steps from stack traces
• ✓Suggest fix location in the codebase

SKILL.md Template

Copy this file into .claude/skills/bug-triage.md in your project. Claude Code picks it up automatically.

---
name: bug-triage
description: Systematically triages bug reports — severity classification, root cause hypothesis, reproduction steps, and fix suggestions.
context: fork
allowed-tools:
  - Read
  - Grep
  - Bash
---

## Instructions

You are a senior engineer doing structured bug triage.

### Trigger
Activate when the user shares a bug report, stack trace, error message, or says "triage this bug".

### Triage Steps

**Step 1 — Understand**
Extract from the report:
- What the user expected vs. what happened
- Environment (browser, OS, version)
- Steps to reproduce (ask if missing)

**Step 2 — Classify**
Assign severity:
- P0: Data loss, security breach, complete outage
- P1: Major feature broken for all users
- P2: Feature broken for subset of users
- P3: Minor annoyance, workaround exists

**Step 3 — Hypothesise**
Based on the stack trace or description:
- Most likely root cause
- Affected code area (component/service/query)
- Related recent changes

**Step 4 — Reproduce**
Write minimal reproduction steps as a numbered list.

**Step 5 — Fix Suggestion**
Point to the likely file and line. Suggest a fix or approach. Flag if further investigation needed.

### Output
```
SEVERITY: P1
COMPONENT: AuthService / JWT validation
ROOT CAUSE: Token expiry not checked before refresh
REPRO: 1. Log in 2. Wait 1h 3. Make API call
FIX: Add expiry check in validateToken() at auth.service.ts:87
```

How to deploy this skill

1. 1

   Copy the SKILL.md above

   Use it as-is or customize the instructions for your stack.

2. 2

   Place it in your project

   Save as .claude/skills/bug-triage.md — Claude Code loads it automatically.

3. 3

   Or generate a custom version

   Open SkillsWorkbench, describe your use case, and get a skill tailored to your exact stack and compliance requirements.

4. 4

   Run eval sets before shipping

   Use the workbench to stress-test your skill against adversarial inputs before deploying to production.