Agent-Skills.md

Agent Skills: Triage New Issues Skill

Use when processing new or untriaged GitHub issues - assesses urgency from keyword and label signals, assigns P0-P3 priority, suggests labels and assignees, and flags issues needing escalation or clarification

UncategorizedID: britt/claude-code-skills/triage-new-issues

Repository

britt/claude-code-skills
brittLicense: MIT
4

Install this agent skill to your local

pnpm dlx add-skill https://github.com/britt/claude-code-skills/tree/HEAD/skills/triage-new-issues

Skill Files

Browse the full folder contents for triage-new-issues.

Download Skill

Loading file tree…

skills/triage-new-issues/SKILL.md

Skill Metadata

Name
triage-new-issues
Description
"Use when processing new or untriaged GitHub issues - assesses urgency from keyword and label signals, assigns P0-P3 priority, suggests labels and assignees, and flags issues needing escalation or clarification"

Triage New Issues Skill

Review new or untriaged GitHub issues, assess priority based on urgency signals, suggest labels, and recommend owners.

When to Use

Activate when:

  • Processing new incoming issues
  • Reviewing untriaged backlog
  • Assessing issue priority
  • Assigning issues to owners

Fetching and Applying Triage

Use the gh CLI (must be installed and authenticated):

# Find untriaged issues
gh issue list --search 'no:label' --json number,title,body,labels

# Apply labels after triage
gh issue edit <n> --add-label <label>

Priority Signals

Critical (P0)

Keywords: "down", "outage", "security", "vulnerability", "production", "urgent", "ASAP", "breach" Labels: critical, security, production Action: Immediate attention required

High (P1)

Keywords: "blocking", "regression", "broken", "can't use", "data loss", "crash" Labels: blocker, regression, priority/high Action: Address this sprint

Medium (P2)

Keywords: "bug", "incorrect", "should", "expected", "wrong" Labels: bug, priority/medium Action: Schedule for upcoming sprint

Low (P3)

Keywords: "nice to have", "minor", "cosmetic", "enhancement", "workaround exists" Labels: enhancement, low-priority Action: Add to backlog

Triage Guidelines

Assessment Process

  1. Read title and full description
  2. Scan for urgency keywords and labels
  3. Check for existing labels that signal priority
  4. Assess impact (how many users affected)
  5. Look for workarounds mentioned
  6. Check if duplicate of existing issue
  7. Determine ownership: check CODEOWNERS, recent git log on affected paths, or past assignees of similar issues — omit the assignee suggestion if none found

When to Escalate

  • Security vulnerabilities → Flag immediately
  • Production outages → Notify on-call
  • Data integrity issues → High priority regardless of other signals

When to Ask Questions

  • Unclear reproduction steps
  • Missing environment details
  • Ambiguous severity ("it's broken" but unclear impact)
  • No indication of urgency or timeline

Red Flags

  • Issues with no response from author (>7 days)
  • Duplicate of closed/wontfix issue
  • Feature request disguised as bug
  • Missing required information from template

Output Structure (per issue)

## Triage: #[number] — [title]

### Priority Assessment

**Urgency**: [Critical | High | Medium | Low]
**Impact**: [Wide | Moderate | Limited]
**Recommended Priority**: P[0-3]

| Signal | Indicator |
|--------|-----------|
| [Keyword/label found] | [What it suggests] |

### Classification

**Type**: [Bug | Feature | Question | Task]
**Area**: [Component or area affected]
**Suggested Labels**: `priority/high`, `bug`, `area/auth`
**Suggested Assignee**: @username — based on CODEOWNERS, git history, or similar past issues (omit if no owner found)

### Assessment

[Summary of the issue and reasoning for priority assignment]

### Clarifying Questions (if needed)

- [ ] [Question to understand severity]

### Recommendation

[Immediate action | Next sprint | Backlog | Needs info | Duplicate of #X]