debug

Generate and test debugging hypotheses across code, logs, and external research.

5|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/thoreinstein/opencode-config --skill debug-thoreinstein
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/thoreinstein/opencode-config/tree/main/skill/debug
Command: npx skills add https://github.com/thoreinstein/opencode-config --skill debug-thoreinstein

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging complex software issues can be time-consuming and error-prone. This Skill guides engineers through structured hypothesis generation, parallel investigations, and documented verification, helping teams converge on root causes and maintain knowledge in Obsidian.

Core Features & Use Cases

  • Hypothesis-driven debugging: Generate, rank, and test hypotheses across code paths, logs, and data flows.
  • Parallel investigation tracks: Run codebase exploration, code analysis, and external research simultaneously to accelerate resolution.
  • Evidence collection & documentation: Systematically collect logs, metrics, and code observations and store narratives in Obsidian.
  • Use Case: When a bug reproduces inconsistently, start multiple investigation tracks to isolate the root cause faster.

Quick Start

Start a new debugging session by describing the symptoms and environment to trigger the investigation workflow.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug inconsistent runtime errors across my codebase?

Debugging inconsistent runtime errors involves generating and testing hypotheses across code paths, logs, and data flows. This Skill runs parallel investigation tracks for codebase exploration and external research to isolate root causes faster.

What is hypothesis-driven debugging and how does it work?

Hypothesis-driven debugging systematically generates, ranks, and tests hypotheses against collected evidence like logs and code observations. It orchestrates parallel investigations to converge on root causes methodically.

Can I use this debugging workflow for failing tests and deployment issues?

Yes, you can use this workflow for failing tests and deployment issues. It applies to software issues across codebases, services, and deployments, collecting evidence to verify hypotheses for any runtime error or test failure.

Do I need Obsidian to document and trace debugging sessions?

Obsidian is used for evidence collection and documentation, storing debugging narratives and collected metrics for traceable knowledge. It enables teams to maintain documented verification of root cause analysis.

What is the best way to analyze logs and code simultaneously during an investigation?

The best way to analyze logs and code simultaneously is using parallel agent orchestration. This Skill runs codebase exploration, code analysis, and external research tracks at the same time to accelerate resolution.

How do I start a structured debugging session?

To start a structured debugging session, describe the symptoms and environment of your software issue. This triggers the investigation workflow, which automates hypothesis generation and parallel evidence collection across code and logs.