debugme

Diagnose failing behavior and regressions with evidence-based observations and root-cause hypotheses.

1|Updated Sep 6, 2024
One-click install
npx skills add https://github.com/carlos18bp/gym_project --skill debugme-carlos18bp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugme
Source: https://github.com/carlos18bp/gym_project/tree/main/.agents/skills/debugme
Command: npx skills add https://github.com/carlos18bp/gym_project --skill debugme-carlos18bp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly diagnose failing behavior or suspected regressions by guiding you to gather evidence and produce actionable debugging insights without modifying the codebase.

Core Features & Use Cases

  • Legacy diagnosis alias: Provides a backward-compatible entry point for teams still using the older debugme name.
  • Read-only workflow: Ensures the assistant focuses on diagnosis only, explicitly avoiding file modifications.
  • Evidence-first debugging: Produces observations, hypothesized root cause, recommended fix, and verification steps for the reported failure.

Quick Start

Provide the error message or failing behavior you are seeing, and ask the assistant to run a read-only diagnosis using the same workflow as $debug.

Frequently Asked Questions about debugme

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

FAQPage Schema
How do I diagnose a regression without modifying any codebase files?

You can diagnose a regression without modifying files by running a read-only, evidence-first workflow that returns observations, a root-cause hypothesis, a recommended fix, and verification steps.

What is an evidence-first debugging workflow for error triage?

Evidence-first debugging is a read-only diagnosis process that analyzes an error message or failing behavior to produce structured observations, a hypothesized root cause, and a verification plan before any changes are made.

How do I find the root cause of a failing behavior from an error message?

To find the root cause of a failing behavior, provide the error message to a read-only diagnosis workflow, which will analyze the evidence and return a hypothesized root cause alongside recommended steps.

Can I investigate suspected breakage in production without changing files?

Yes, you can investigate suspected breakage using a strictly read-only diagnosis process that explicitly avoids file modifications and delivers evidence-based observations, root cause, and a fix recommendation.

What is the best way to triage errors and plan a fix without touching code?

The best way to triage errors without touching code is applying a read-only diagnosis workflow that gathers evidence to output a root-cause hypothesis, recommended fix, and verification steps.

What are the limitations of a read-only debugging diagnosis process?

The limitation of a read-only debugging diagnosis is that it only provides observations, root cause, and a recommended fix without actually applying the modifications or verifying the resolution directly in the codebase.