One-click install
npx skills add https://github.com/jacob-balslev/skill-graph --skill diagnosis-jacob-balslev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnosis
Source: https://github.com/jacob-balslev/skill-graph/tree/main/marketplace/skills/diagnosis
Command: npx skills add https://github.com/jacob-balslev/skill-graph --skill diagnosis-jacob-balslev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosis helps you stop guessing during an incident by classifying an unknown software failure into the right problem class, collecting the minimum evidence needed to support that classification, and selecting a fitting diagnostic technique before any root-cause debugging begins.

Core Features & Use Cases

  • Symptom classification taxonomy (9 classes): Logic Error, Runtime Crash, Data Integrity, Timing / Race, Performance, Configuration, Security, Integration, and Tooling / Build / Script-path.
  • Evidence-first diagnostic protocol: Defines universal evidence to collect (exact error/wrong output, reproduction steps, last-known-good state, environment facts) and class-specific evidence checklists.
  • Technique-selection matrix: Chooses the cheapest technique compatible with the class (e.g., stack-trace reading for crashes, differential comparison for configuration, profiling for performance, boundary probing for integrations).
  • Confidence ladder and reclassification rules: Keeps confidence monotonic with explicit “you can say / you cannot say” boundaries and escalation triggers when stuck.
  • Cross-domain patterns: Handles compound scenarios like Cascade, Coincidence, and Environment Ghosts to prevent misleading conclusions.

Quick Start

Use the diagnosis skill to classify an error from its symptoms, collect the required evidence, and route to the most efficient diagnostic approach while tracking confidence and escalation criteria.

Frequently Asked Questions about diagnosis

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

FAQPage Schema
How do I triage software failures before starting root cause debugging?

Software failure triage requires classifying the incident into a structured problem taxonomy, collecting evidence like reproduction steps and environment facts, and selecting a matching diagnostic technique to build debugging confidence.

What evidence do I need to collect for incident investigation?

Incident investigation requires universal evidence including exact error messages, reproduction steps, last-known-good state, and environment facts, supplemented by class-specific evidence checklists based on the failure type.

How should I classify an unknown software crash or race condition?

Classify an unknown software crash or race condition by matching symptoms against a nine-class taxonomy covering logic errors, runtime crashes, data integrity, timing, performance, configuration, security, integration, and tooling issues.

What is the best way to choose a diagnostic technique for a performance regression?

Choosing a diagnostic technique for a performance regression involves using a technique-selection matrix that matches the problem class, such as selecting profiling for performance issues or differential comparison for configuration discrepancies.

When should I escalate or reclassify a software failure during triage?

Escalate or reclassify a software failure during triage when confidence stalls, using a confidence ladder with explicit boundaries and escalation triggers to handle compound scenarios like cascades, coincidences, or environment ghosts.