diagnostic-fix

Diagnose root causes of code errors and apply targeted fixes using GitNexus knowledge graph tracing.

3|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/ruskicoder/system-prompts --skill diagnostic-fix-ruskicoder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnostic-fix
Source: https://github.com/ruskicoder/system-prompts/tree/main/prompt-orchestrator/.opencode/skills/diagnostic-fix
Command: npx skills add https://github.com/ruskicoder/system-prompts --skill diagnostic-fix-ruskicoder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging often devolves into guesswork where developers patch symptoms instead of root causes, apply multiple unverified changes at once, or refactor unrelated code. This Skill enforces a structured diagnostic-then-fix workflow that isolates the true root cause before any code is modified. ## Core Features & Use Cases - Structured Six-Phase Workflow: Gathers symptoms, traces root causes with the Ariya-4 problem frame (Problem, Cause, Cessation, Path), confirms hypotheses via reproduction, applies minimal fixes, and verifies results. - GitNexus Knowledge Graph Integration: Uses query, context, trace, and detect_changes to map call chains, inspect suspect symbols, and measure the blast radius of every fix. - Hallucination Guardrails: Built-in sanity checklists prevent common failure modes like fixing symptoms, editing in loops without verification, or bundling multiple fixes. - Use Case: When a payment endpoint returns intermittent 500 errors, the workflow traces the call chain from the handler to an external API call missing a timeout, applies a single targeted fix, and confirms only the expected file changed. ## Quick Start Invoke the diagnostic-fix workflow with an error message or stack trace, such as asking the agent to diagnose why the checkout endpoint intermittently returns 500 errors.

Frequently Asked Questions about diagnostic-fix

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

FAQPage Schema
How do I find the root cause of a bug instead of fixing symptoms?▼

Follow a diagnostic-then-fix workflow: gather exact symptoms and error messages, trace the execution path to the suspect code, confirm the hypothesis by reproducing the issue, then apply one minimal fix. This Skill enforces that sequence with explicit phase checklists.

How to trace a call chain between two functions in a codebase?▼

Use the GitNexus trace command with a from and to symbol to find the shortest call chain between an entry point and an error site. Combine it with query to locate suspect symbols and context to see all callers and callees.

What is the Ariya-4 problem frame for debugging?▼

The Ariya-4 frame requires completing four fields before any fix: Problem (the broken root mechanism), Cause (structural root causes), Cessation (measurable definition of done), and Path (the least-friction route to resolution). It prevents premature fixes based on surface symptoms.

Does this workflow require GitNexus to be installed?▼

Yes, the workflow depends on GitNexus for query, context, trace, and detect_changes operations against the codebase knowledge graph. If the index is stale, run npx gitnexus analyze before starting the diagnostic phases.

Why do multiple fixes applied at once cause debugging problems?▼

Applying several changes simultaneously makes it impossible to know which change actually resolved the issue and can introduce new regressions. The workflow mandates one minimal targeted fix per cycle, verified with tests and detect_changes to confirm scope.

What are the token limits for running a diagnostic workflow?▼

A typical diagnostic session consumes 10K to 40K tokens, with 80K as the recommended maximum. Beyond 80K tokens, the workflow recommends session summarization to avoid context degradation.