One-click install
npx skills add https://github.com/honerlaw/agent-marketplace --skill debug-honerlaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/honerlaw/agent-marketplace/tree/main/plugins/minerva/skills/debug
Command: npx skills add https://github.com/honerlaw/agent-marketplace --skill debug-honerlaw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you investigate reported breakage (live incidents or dev bugs) by gathering concrete evidence first, then diagnosing root cause strictly grounded in that evidence.

Core Features & Use Cases

  • Evidence-first investigation: Collects logs, metrics, source code, test output, and configuration details into an evidence ledger before making any causal claims.
  • Root-cause diagnosis with citations: Produces hypotheses and identifies the offending layer and code only after correlating evidence artifacts.
  • Confidence-tiered reporting: Outputs a mechanically-derived confidence level (Confirmed/Probable/Suspected/Unknown) based on what was actually reproduced and inspected.
  • Safe mutation discipline: Avoids state-changing actions that could affect other users without explicit per-turn confirmation.

Quick Start

Use the debug skill when users report breakage or when a test or error message indicates something is failing, and ask it to investigate end-to-end with an evidence ledger and confidence score.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I investigate a root cause for a 500 error or timeout using an evidence ledger?

To investigate a root cause for a 500 error or timeout, collect logs, metrics, source code, and configuration details into an evidence ledger before diagnosing the offending layer. This evidence-first approach ensures causal claims are strictly grounded in cited artifacts.

What is the best way to triage test failures and deployment regressions without making unsupported causal claims?

The best way to triage test failures and deployment regressions is to correlate evidence artifacts from an evidence ledger to identify the offending layer. This method enforces a minimum evidence breadth gate across artifact categories, preventing unsupported causal claims during diagnosis.

How does confidence scoring work when diagnosing unexpected exceptions or incorrect function outputs?

Confidence scoring for unexpected exceptions and incorrect function outputs works by mechanically deriving a confidence tier (Confirmed, Probable, Suspected, or Unknown) based strictly on what was actually reproduced and inspected from the collected evidence ledger.

Can I use read-only investigation for incident response without risking state-changing actions on shared systems?

Yes, you can use read-only investigation for incident response without risking state-changing actions. This approach requires explicit per-turn confirmation before any mutation that could affect shared systems, ensuring safe investigation of live incidents and development bugs.

When do I need to gather configuration details and test output for a stuck job or deployment failure?

You need to gather configuration details and test output for a stuck job or deployment failure immediately upon reported breakage. Collecting these artifacts into an evidence ledger before making any causal claims ensures accurate root cause diagnosis across all project layers.