triage

Identify bug root causes and generate GitHub issues with TDD fix plans.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/arvindbattula/my-agent-config --skill triage-arvindbattula
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/arvindbattula/my-agent-config/tree/main/skills/triage
Command: npx skills add https://github.com/arvindbattula/my-agent-config --skill triage-arvindbattula

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage a bug or issue by exploring the codebase to find the root cause, then create a GitHub issue with a TDD-based fix plan. This structured workflow helps teams move from symptom to a concrete, testable solution with minimal user prompts.

Core Features & Use Cases

  • Capture and describe the issue succinctly.
  • Reproduce, Localize, and Reduce the bug to its root cause using a guided triage checklist.
  • Generate a GitHub issue with a clear TDD-based fix plan, including tests and acceptance criteria.
  • Applicable for user-reported bugs, flaky tests, regression symptoms, and roadmap tasks that require investigation.

Quick Start

Describe the observed issue in as much detail as possible and prompt the agent to begin the triage workflow.

Frequently Asked Questions about triage

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

FAQPage Schema
How do I find the root cause of a bug for a TDD-based fix plan?

To find the root cause of a bug for a TDD-based fix plan, explore relevant code paths and dependencies using a guided triage workflow that reproduces, localizes, and reduces the issue to verifiable remediation steps.

What is the best way to triage user-reported bugs and regression symptoms?

Triage user-reported bugs and regression symptoms by applying a structured checklist that explores the codebase to identify the root cause, producing a GitHub issue with tests, acceptance criteria, and a minimal fix plan.

How do I create a GitHub issue with tests and acceptance criteria for debugging sessions?

Create a GitHub issue with tests and acceptance criteria for debugging sessions by describing the observed issue, triaging code paths to find the root cause, and generating a TDD-based remediation plan with minimal verifiable fixes.

Can I use this triage workflow for flaky tests and roadmap investigation tasks?

Yes, you can use this triage workflow for flaky tests and roadmap investigation tasks because it applies to any scenario requiring root-cause localization, producing a structured TDD-based fix plan for each investigated issue.

What do I need to start debugging and localizing an issue in my codebase?

To start debugging and localizing an issue in your codebase, you need to provide a detailed description of the observed symptom so the triage workflow can explore dependencies and generate a targeted GitHub issue for the fix.

Why does my bug fix lack clear acceptance criteria and test coverage?

Your bug fix lacks clear acceptance criteria and test coverage because a structured root-cause triage workflow was not applied to generate a TDD-based fix plan with verifiable tests and minimal remediation steps in a GitHub issue.