dev-debug

Diagnose software bugs and commit minimal corrective code changes.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Srajangpt1/dataeye --skill dev-debug-srajangpt1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-debug
Source: https://github.com/Srajangpt1/dataeye/tree/main/packages/browseros-agent/.claude/skills/dev-debug
Command: npx skills add https://github.com/Srajangpt1/dataeye --skill dev-debug-srajangpt1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A structured, repeatable workflow for diagnosing software issues, identifying the most probable root causes, implementing minimal fixes, testing them, and committing changes so developers can resolve bugs efficiently and with audit trails.

Core Features & Use Cases

  • Root-cause analysis: Guides the user to produce a ranked list of 2–5 probable causes and records the analysis in .llm/debug_<slug>/tmp_root_causes.md.
  • Focused fixes: Instructs to implement minimal, pattern-consistent code changes and avoid broad refactors.
  • Testing and commits: Directs running existing tests or defining manual test steps, and enforces staging and committing fixes with a clear message.
  • Use Case: Quickly triage a failing integration test by tracing relevant code paths, proposing ranked causes, applying the most likely fix, and committing the change.

Quick Start

Invoke the skill with /dev-debug followed by a concise description of the issue to generate the debug directory, a ranked root-cause analysis, and a proposed minimal fix.

Frequently Asked Questions about dev-debug

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

FAQPage Schema
How do I debug a failing integration test and trace the root cause in my code?

To debug a failing integration test, you trace relevant code paths to generate a ranked list of 2–5 probable root causes. This root-cause analysis is recorded in a temporary markdown file before applying fixes.

What is the best way to fix software bugs without introducing broad refactors?

The best way to fix software bugs without broad refactors is to implement minimal, pattern-consistent code changes. This targeted approach ensures the corrective fix directly addresses the identified root cause.

Do I need a git workspace to commit code fixes during debugging?

Yes, you need a git workspace to commit code fixes during debugging. The workflow requires access to the project source and a git workspace to stage and commit the applied minimal fixes with a clear message.

How does root-cause analysis work for CI-failure investigations?

Root-cause analysis for CI-failure investigations works by diagnosing software issues, identifying probable causes, and recording the analysis in a debug directory. This creates an audit trail for local development and CI scenarios.

How do I test and commit minimal code fixes after identifying a bug?

To test and commit minimal code fixes, you run existing tests or define manual test steps to validate the change. Once verified, you stage and commit the fixes to your git workspace with a clear commit message.

When should I not use a structured debugging workflow for code fixes?

You should not use a structured debugging workflow for code fixes if your scenario lacks access to the project source or a git workspace. This workflow specifically requires reproducing steps, tracing code paths, and committing fixes.