debug

Diagnose software issues through a structured reproduce, isolate, diagnose, and fix workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When something breaks and the cause isn't obvious, ad-hoc guessing wastes time. This Skill provides a systematic four-step debugging session that moves from reproduction to root cause to a verified fix. ## Core Features & Use Cases - Structured Four-Step Process: Reproduce the issue, isolate the affected component, diagnose the root cause, and propose a fix with regression tests. - Structured Debug Report: Outputs a consistent report covering expected vs. actual behavior, root cause, fix, and prevention measures. - Connector-Aware Context: When monitoring, source control, or project tracker connectors are available, it pulls logs, recent deploys, and related commits to correlate the issue with recent changes. - Use Case: You paste a production stack trace and mention it started after yesterday's deploy; the Skill narrows the suspect code path, identifies the root cause, and suggests a fix plus a regression test. ## Quick Start Invoke the debug skill with your error message or a description of the problem, such as "/debug this API returns 500 only for large payloads after the latest deploy".

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug an error with a stack trace using AI?

Invoke the debug skill and paste the exact error message or stack trace. It walks through reproduction, isolation, and diagnosis steps, then outputs a report with the root cause, a proposed fix, and prevention tests.

How to find the root cause of a bug that only happens in production?

Provide the error details plus what differs between environments, such as config, data volume, or recent deploys. The skill isolates the affected component and correlates the failure with recent changes to identify the root cause.

What information should I provide when reporting a bug for debugging?

Share the exact error text, steps to reproduce, expected versus actual behavior, and anything that changed recently such as deploys or dependency updates. Logs and screenshots also help narrow the scope quickly.

Can the debug skill use monitoring logs and git history?

Yes, when monitoring, source control, or project tracker connectors are connected, it pulls logs, error rates, recent deploys, and commits touching affected code paths to correlate the issue with specific changes.

When is a structured debugging workflow not the right approach?

It is less useful for trivial typos or known issues with documented fixes, where direct correction is faster. It adds the most value when the cause is non-obvious and behavior diverges from expectations.