debug

Diagnoses software failures by reproducing, isolating, and explaining root causes.

2|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/rakibulism/agent-skills-os --skill debug-rakibulism
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/rakibulism/agent-skills-os/tree/main/skills/engineering-debug
Command: npx skills add https://github.com/rakibulism/agent-skills-os --skill debug-rakibulism

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose broken behavior when the cause is unclear, turning vague failures, stack traces, and “works here but not there” incidents into a structured investigation.

Core Features & Use Cases

  • Reproduce and scope issues: Clarifies expected versus actual behavior, exact steps to trigger the problem, and who or what is affected.
  • Isolate and diagnose root cause: Narrows the failure to a specific component, code path, deploy, or configuration change using logs and recent changes.
  • Propose fixes and prevention: Recommends a fix, considers edge cases and side effects, and suggests regression tests or safeguards.
  • Use case: A deployment starts failing in production only after a config change; this Skill guides the investigation from symptoms to root cause and a safe remediation plan.

Quick Start

Tell the agent the exact error message, what changed recently, and the steps to reproduce the issue.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I find the root cause of a production-only incident after a deployment?

To find the root cause of a production incident, reproduce the failure by analyzing logs and recent configuration changes to isolate the specific code path causing the unexpected behavior. This structured investigation narrows symptoms down to the exact deploy or component triggering the regression.

What is the best way to troubleshoot a stack trace when the error is unclear?

Troubleshooting an unclear stack trace involves clarifying expected versus actual behavior and identifying exact trigger steps. Structured analysis of recent code changes and logs isolates the failing component and explains the root cause of the unexpected behavior.

How do I isolate a post-deploy regression in my code?

Isolate a post-deploy regression by comparing expected results with observed behavior and reviewing recent changes. Structured log analysis and code path examination narrow the failure down to the specific component or configuration change responsible for the broken behavior.

Can I use this to diagnose issues that only happen in certain environments?

Yes, you can diagnose environment-specific failures by clarifying the exact steps to trigger the problem and scoping who or what is affected. It analyzes logs and code paths to explain why behavior diverges across different environments.

What information do I need to provide to start debugging an incident?

To start debugging an incident, provide the exact error message, a description of what changed recently, and the specific steps required to reproduce the issue. This input enables structured analysis of logs and code paths to isolate the root cause.

How do I prevent a fixed regression from happening again in the future?

To prevent a fixed regression from recurring, apply the recommended regression tests and safeguards provided after the root cause is isolated. The analysis considers edge cases and side effects to propose a safe remediation plan that prevents future incidents.