triage-issue

Explore a codebase to identify root causes and generate a GitHub issue with a TDD fix plan.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ClyptAI/Clypt-Frontend --skill triage-issue-clyptai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage-issue
Source: https://github.com/ClyptAI/Clypt-Frontend/tree/main/.agents/skills/mattpocock-skills/triage-issue
Command: npx skills add https://github.com/ClyptAI/Clypt-Frontend --skill triage-issue-clyptai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage a bug or issue by exploring the codebase to identify the root cause, then create a GitHub issue with a TDD-based fix plan.

Core Features & Use Cases

  • Structured triage workflow that guides investigation from symptom to root cause.
  • Generate a GitHub issue containing a concrete, test-driven fix plan using RED-GREEN cycles.
  • Works for user-reported bugs, regressions, or problems described in logs or QA notes.

Quick Start

Describe the problem briefly to start the triage workflow and let the agent generate a GitHub issue with 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 a bug report and identify the root cause in a codebase?

To triage a bug and identify the root cause, you need a structured workflow that guides investigation from the reported symptom to the actual underlying issue. This process explores the codebase to pinpoint the fault and prepares a structured fix plan.

What is a TDD-based fix plan and how does it resolve codebase regressions?

A TDD-based fix plan resolves codebase regressions by documenting a test-driven approach using RED-GREEN cycles. It ensures the identified root cause is fixed by first writing failing tests, then implementing minimal fixes to make them pass.

How do I create a GitHub issue from a user-reported bug or QA note?

To create a GitHub issue from a user-reported bug or QA note, you triage the described problem by exploring the codebase to find the root cause. You then generate a structured GitHub issue containing a concrete, test-driven fix plan.

Can I use a TDD fix plan for feature regressions found in logs?

Yes, you can use a TDD fix plan for feature regressions found in logs. The triage workflow applies to problems described in logs, user-reported bugs, or QA notes across diverse repositories to propose minimal fixes.

What is the best way to propose minimal fixes for a software bug?

The best way to propose minimal fixes for a software bug is through a structured triage workflow that identifies the root cause. It generates a GitHub issue with a test-driven plan, ensuring fixes are validated through RED-GREEN cycles.