skills.rest
zaeem-rafiq
zaeem-rafiqCOMMUNITY
Explore all skills by this author →
GitHub

triage-issue

Triage bug reports into root-cause analysis and TDD-aligned fix plans.

Updated Mar 28, 2026
Search Tags:#tdd#triage#hypothesis#reproduction#root-cause-analysis#bug-report#triage-report
One-click install
npx skills add https://github.com/zaeem-rafiq/tatheer-swift-sdk --skill triage-issue-zaeem-rafiq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage-issue
Source: https://github.com/zaeem-rafiq/tatheer-swift-sdk/tree/main/.claude/skills/dev-workflow/triage-issue
Command: npx skills add https://github.com/zaeem-rafiq/tatheer-swift-sdk --skill triage-issue-zaeem-rafiq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigate bug reports to produce a structured root-cause analysis and a TDD-friendly fix plan, guiding engineers to gather evidence, reproduce steps, and propose durable, testable solutions.

Core Features & Use Cases

  • Structured triage workflow that collects observed behavior, reproduction steps, environment details, and logs.
  • Hypothesis generation and prioritized root-cause analysis with a stepwise test plan.
  • TDD-aligned fix planning that translates findings into test cases and acceptance criteria.

Quick Start

Provide a bug report with evidence to trigger a full triage analysis.

Frequently Asked Questions about triage-issue

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

FAQPage Schema
How do I perform root-cause analysis on a bug report?▼

To perform root-cause analysis, provide a bug report with evidence to trigger a full triage. The workflow collects observed behavior, reproduction steps, and environment logs to generate a structured, testable root-cause hypothesis.

What is the best way to structure a bug triage workflow?▼

The best way to structure bug triage is using a workflow that enforces reproducible procedures, checks reproducibility, and prioritizes root-cause hypotheses. This translates findings into a TDD-aligned fix plan with clear acceptance criteria.

How do I create a TDD-aligned fix plan from a bug report?▼

To create a TDD-aligned fix plan, translate triage findings and root-cause hypotheses into specific test cases and acceptance criteria. This ensures the bug fix is verifiable and drives stepwise implementation across environments.

Can I use structured triage to check bug reproducibility across environments?▼

Yes, structured triage performs reproducibility checks by guiding engineers through stepwise verification across environments. It collects environment details and logs to validate reproduction steps and document the root cause.

When do I need a structured triage report for bug resolution?▼

You need a structured triage report when a bug requires durable, testable solutions and clear root-cause documentation. It is used to translate complex evidence and reproduction steps into a stepwise test plan and acceptance criteria.

Related Skills

Explore More Software Engineering Skills→
Smooth-OperationSmooth-Operation

systematic-debugging

Diagnose software bugs with a five-step reproduce, isolate, identify, fix, and verify workflow.

Official
Basic
RemseyMailjardRemseyMailjard

triage-issue

Investigate a reported bug and create a GitHub issue with a TDD fix plan.

Community
Intermediate
Arbab1308Arbab1308

systematic-debugging

Apply a 4-phase debugging process to identify and outline root causes.

Community
Intermediate
ShubhamsabooShubhamsaboo
131.7k

debugger

Diagnose software errors through structured root-cause analysis and hypothesis testing.

Community
Basic