debugging-first

Enforce evidence-first debugging with logs, network, and state checks.

2|2|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/adilkalam/orca --skill debugging-first
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-first
Source: https://github.com/adilkalam/orca/tree/main/skills/debugging-first
Command: npx skills add https://github.com/adilkalam/orca --skill debugging-first

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Promotes debugging-first—gather evidence (console, network, state) before touching code.

Core Features & Use Cases

  • Evidence-first workflow: Prioritize logs, network, and state.
  • Targeted fixes: Use evidence to drive precise changes.
  • Use Case: When a bug arises, capture logs and reproduce before editing.

Quick Start

Start with console and network checks, then proceed to code inspection if needed.

Frequently Asked Questions about debugging-first

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

FAQPage Schema
How do I debug application issues systematically without guessing?

Debugging systematically means gathering evidence first—check console logs, network traffic, and application state before modifying code. This evidence-first approach eliminates guesswork by identifying the root cause through structured investigation of logs, network requests, and runtime state across browser, server, and CI environments.

What should I check first when debugging a web application?

Start with console logs and network traffic to capture error messages and failed requests. Prioritize these checks before inspecting code, then move to application state inspection if needed. This ordered workflow—logs, network, state, code—ensures you've collected diagnostic evidence before attempting fixes.

Can I use an evidence-first workflow for server and API debugging?

Yes, evidence-first debugging applies to web and server applications including login failures, UI rendering issues, API errors, and performance regressions. Collect structured evidence from console logs, network traffic, and application state in browser, server, and CI environments before modifying code.

How do I verify a bug fix actually resolved the issue?

After making a targeted fix based on collected evidence, verify the fix by reproducing the original problem and confirming it no longer occurs. This verification step completes the disciplined debugging workflow and ensures your minimal, evidence-driven changes address the root cause.

Why should I capture logs and reproduce issues before editing code?

Capturing logs and reproducing issues before editing creates a record of the problem's symptoms and conditions. This evidence enables hypothesis testing and targeted, minimal fixes rather than trial-and-error changes, reducing time spent on incorrect solutions.