triage-issue

Diagnose bug root causes and create GitHub issues with TDD fix plans.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you move from a vague bug report to a reliable root-cause understanding and a concrete TDD-based fix plan that you can execute safely.

Core Features & Use Cases

  • Codebase investigation: Explores the relevant entry points, code paths, tests, error handling, and recent changes to locate the root cause rather than just symptoms.
  • Fix approach selection: Chooses the smallest change that addresses the underlying failure mode and identifies what must be verified.
  • TDD vertical-slice plan: Produces an ordered RED-GREEN cycle list that specifies observable behavior contracts and minimal implementation changes.

Quick Start

Use triage-issue to investigate the reported problem, find the root cause, and create a GitHub issue containing a TDD fix plan.

Frequently Asked Questions about triage-issue

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

FAQPage Schema
How do I find the root cause of a bug in my codebase?

To find the root cause of a bug, you need agent-based codebase exploration that investigates entry points, code paths, and recent changes. This process focuses on observable contracts to locate the underlying failure mode rather than just treating symptoms.

How do I create a GitHub issue with a TDD fix plan?

You can create a GitHub issue with a TDD fix plan by using agent exploration to diagnose the defect and then generating a structured RED-GREEN test cycle. This plan specifies minimal implementation changes and behavior contracts directly within the issue.

What is the best way to plan a test-driven development fix for a reported defect?

The best way to plan a test-driven development fix is to produce an ordered RED-GREEN cycle list. This approach identifies the smallest change needed to address the failure and specifies observable behavior contracts that must be verified.

Does bug triage require investigating recent code changes and error handling?

Yes, effective bug triage requires investigating recent code changes and error handling to determine the root cause. Exploring these relevant code paths ensures you understand the observable contracts and can plan a reliable fix.

When do I need to triage a GitHub issue instead of immediately fixing the code?

You need to triage a GitHub issue when a user reports a vague defect and you require root-cause reasoning before acting. This ensures you move from a simple bug report to a concrete, safe TDD-based fix plan.

Can I use triage-issue to investigate failing behavior without writing tests manually?

You can use it to investigate failing behavior and generate a test plan, but you still need to execute the plan. It produces the structured RED-GREEN test cycle list that specifies the minimal implementation changes required for the fix.