issue-resolution

Diagnose and resolve software issues through triage, reproduction, root cause analysis, and verification.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/thanhquan3010/hospital-management-system-v3 --skill issue-resolution-thanhquan3010
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-resolution
Source: https://github.com/thanhquan3010/hospital-management-system-v3/tree/main/.agents/skills/issue-resolution
Command: npx skills add https://github.com/thanhquan3010/hospital-management-system-v3 --skill issue-resolution-thanhquan3010

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured, step-by-step process to systematically diagnose, reproduce, and resolve software bugs and unexpected behavior, ensuring thorough root cause analysis and verified fixes.

Core Features & Use Cases

  • Triage: Classify issue severity and normalize input.
  • Reproduction: Prove bugs with deterministic tests.
  • Root Cause Analysis: Identify the underlying 'why' using hypotheses and evidence.
  • Impact Assessment: Understand the blast radius before fixing.
  • Fix Decomposition: Break down fixes into manageable 'beads'.
  • Verification: Ensure fixes are correct and don't introduce regressions.
  • Use Case: When a critical production bug is reported, this Skill guides the engineer through a rigorous process to pinpoint the exact cause, implement a fix, and verify its effectiveness without introducing new issues.

Quick Start

Use the issue-resolution skill to start diagnosing a bug reported in the 'user-login' module.

Frequently Asked Questions about issue-resolution

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

FAQPage Schema
What is the best way to systematically diagnose and fix software bugs?

Yes, root cause analysis helps identify the underlying 'why' of unexpected software behavior by leveraging hypotheses and evidence. This structured approach ensures you pinpoint the exact cause of critical production bugs before attempting any fixes.

How do I reproduce a software bug with a deterministic test?

To reproduce a software bug, you must prove it with deterministic tests during the reproduction phase of issue resolution. This normalizes the input and confirms the unexpected behavior exists before moving to root cause analysis and fix decomposition.

How do I assess the blast radius impact of a critical production bug before fixing it?

Assessing the blast radius of a production bug is achieved through impact assessment, which helps you understand the scope of the issue before fixing. This prevents widespread regressions when applying the decomposed fix.

Can I use git and oracle for structured problem-solving during issue resolution?

Yes, you can use tools like git, oracle, and bd for structured problem-solving and iterative debugging. These tools assist throughout the comprehensive framework to systematically diagnose, reproduce, and resolve software issues.

How do I verify a software fix is correct and does not introduce regressions?

Verifying a software fix requires checking that the resolution is correct and does not introduce new issues or regressions. This verification step is the final phase in a comprehensive issue resolution framework after fix decomposition.