triage-issue

Explore codebases to diagnose root causes and draft TDD fix plans.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/caezium/skills --skill triage-issue-caezium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage-issue
Source: https://github.com/caezium/skills/tree/main/triage-issue
Command: npx skills add https://github.com/caezium/skills --skill triage-issue-caezium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams systematically triage bugs by exploring the codebase to identify root causes and generate a structured GitHub issue with a TDD-based fix plan.

Core Features & Use Cases

  • Guided problem capture and scope definition for user-reported bugs.
  • Deep codebase exploration to trace the bug to its root cause and related patterns.
  • Creation of a concise GitHub issue with a RED-GREEN cycle-based fix plan to guide implementation.
  • Supports documenting tests, acceptance criteria, and a clear remediation path for maintainers.

Quick Start

Capture a bug description and start exploration to identify the root cause, then draft a TDD-based 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 triage bugs and find their root cause in my codebase?

To triage bugs effectively, you need a structured plan that explores the codebase to identify root causes. This approach guides systematic investigation to trace reported issues and related patterns before drafting a fix.

How do I create a GitHub issue with a TDD-based fix plan for a bug?

Creating a GitHub issue with a TDD-based fix plan involves documenting RED-GREEN cycles, acceptance criteria, and a clear remediation path. This structure guides maintainers through writing failing tests first, then implementation.

What is the best way to investigate user-reported issues systematically?

The best way to investigate user-reported issues is through guided problem capture and scope definition. Deep codebase exploration then traces the bug to its root cause, ensuring a disciplined workflow before any code changes.

Can I use a structured triage workflow for internal bugs without external dependencies?

Yes, a structured triage workflow applies to both user-reported issues and internal bugs. It operates without external dependencies, enforcing a disciplined capture, exploration, and root-cause analysis process.

What should be included in a bug fix plan to guide implementation?

A bug fix plan should include documented tests, acceptance criteria, and a clear remediation path. Structuring it with RED-GREEN cycles ensures maintainers write failing tests first, then implement the passing code.

Why does my bug triage process fail to identify the actual root cause?

Bug triage often fails to identify root causes when lacking deep codebase exploration to trace related patterns. A disciplined workflow enforcing capture, exploration, and analysis is required to avoid missing underlying issues.