Skills › Engineering › Bug Triage Summary

Bug Triage Summary

Pull open bug issues from GitHub, research known solutions for each, and produce a prioritised triage summary.

Superpowers: handler_dev · handler_research · handler_generate

Requires connection: GitHub

When to use: You have a backlog of open bugs and need to prioritise them with context before a triage meeting.

Steps

Fetch open bug issues from GitHub

Superpower: handler_dev — live API reference →

POST /v2/superpowers/handler_dev
{
  "action": "GITHUB_LIST_REPOSITORY_ISSUES",
  "owner": "myorg",
  "repo": "myapp",
  "labels": "bug",
  "state": "open",
  "per_page": 20
}

Returns up to 20 open bugs with titles, descriptions, and labels.

Research the top bug for known solutions

Superpower: handler_research — live API reference →

POST /v2/superpowers/handler_research
{
  "task": "answer",
  "query": "How to fix: [bug title and description from step 1]"
}

From previous step: issues[0].title + issues[0].body from step 1 → form into research query

Generate a triage summary

Superpower: handler_generate — live API reference →

POST /v2/superpowers/handler_generate
{
  "task": "chat",
  "prompt": "You are a senior engineer doing bug triage. For each bug: (1) one-line description, (2) estimated severity (P0/P1/P2/P3) based on the description, (3) recommended owner type (frontend/backend/infra), (4) whether a known fix exists. Order by recommended priority. Bugs: [step 1 results]"
}

From previous step: issue list from step 1 → inject as bugs

Outcome: Prioritised bug triage: severity ratings, owner assignments, and known fix pointers.

Fetch this skill via API

GET /v2/skills/bug-triage-summary
Authorization: Bearer sk-hndlr-...