triage-issue

Investigate a reported bug and create a GitHub issue with a TDD fix plan.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/RemseyMailjard/superpowers --skill triage-issue-remseymailjard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage-issue
Source: https://github.com/RemseyMailjard/superpowers/tree/main/.github/skills/triage-issue
Command: npx skills add https://github.com/RemseyMailjard/superpowers --skill triage-issue-remseymailjard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigate a reported problem, find its root cause, and create a GitHub issue with a TDD fix plan. This is a mostly hands-off workflow - minimize questions to the user.

Core Features & Use Cases

  • Capture and document the problem succinctly
  • Deep-dive exploration to identify root cause and affected modules
  • Design a concrete TDD-based fix plan with minimal, testable steps
  • Create a structured GitHub issue that guides developers from red to green

Quick Start

Provide a brief bug description to begin the triage process and let the agent start investigating immediately.

Frequently Asked Questions about triage-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub issue with a TDD fix plan for a reported bug?

To create a GitHub issue with a TDD fix plan, the Skill investigates a reported bug, identifies the root cause, and outputs structured acceptance criteria enforcing a RED-GREEN cycle to guide developers from failure to passing tests.

What is the best way to investigate a root cause and document a bug fix plan?

Investigating a root cause involves deep-dive exploration to identify affected modules, capturing the problem succinctly, and designing a concrete TDD-based fix plan with minimal, testable steps for developers to follow.

Do I need to provide a detailed bug report to start the triage process?

You do not need a detailed bug report to start the triage process; providing a brief bug description is sufficient for the agent to begin a mostly hands-off investigation immediately.

How does TDD triage apply to an existing codebase when a bug is reported?

TDD triage applies to an existing codebase by capturing the reported issue, exploring the project to find the root cause, and creating a well-formed GitHub issue with a test-driven development plan to fix it.

Can I automate bug triage and issue creation without manual intervention?

You can automate bug triage with minimal manual intervention using this workflow, which minimizes questions and independently handles problem documentation, root-cause analysis, and GitHub issue generation.