triage-issue

Investigate codebases to create GitHub issues with TDD fix plans.

Updated Aug 23, 2026

Search Tags:#planning #tdd #codebase #github #issue #triage #bug

Ready to run

npx skills add https://github.com/Amfsa-tech/task-hub-backend --skill triage-issue-amfsa-tech

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: triage-issue
Source: https://github.com/Amfsa-tech/task-hub-backend/tree/main/skills/triage-issue
Command: npx skills add https://github.com/Amfsa-tech/task-hub-backend --skill triage-issue-amfsa-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage a bug or issue by constructing a clear, actionable GitHub issue with a structured TDD-based fix plan after a focused investigation.

Core Features & Use Cases

Provides an end-to-end workflow to capture problems, diagnose root causes, and design fix plans.
Produces a documented GitHub issue with a RED-GREEN-based TDD plan that guides implementation and testing.
Supports regression and new-issue scenarios by outlining acceptance criteria, test cases, and proposed scope.

Quick Start

Describe the issue to the agent and let it investigate the codebase, identify the root cause, and draft a GitHub issue with a concrete 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 create a GitHub issue with a TDD fix plan for a bug?▼

To triage a bug, describe the issue to the agent and it investigates the codebase, identifies the root cause, and drafts a GitHub issue containing a TDD-based fix plan with acceptance criteria and a RED-GREEN cycle.

What is a RED-GREEN cycle plan in bug triage?▼

A RED-GREEN cycle plan is a TDD-based approach in bug triage that enforces observable outcomes by defining failing tests first, then guiding code changes to make them pass.

Can I use this to triage a regression bug in my existing codebase?▼

Yes, you can triage a regression bug in your codebase. The workflow supports regression scenarios by diagnosing root causes and outlining proposed scope, test cases, and acceptance criteria.

How do I investigate root causes before writing a bug fix plan?▼

To investigate root causes before writing a fix plan, the agent performs a focused codebase investigation with minimal user prompts, capturing the problem and analyzing it before designing the fix.

Does bug triage work without exposing internal implementation details?▼

Yes, bug triage works without exposing internal implementation details. It produces a structured GitHub issue template focusing on observable outcomes and acceptance criteria rather than internal logic.