debugger

Diagnose Rails errors and failing specs with a root-cause-first workflow.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/reckerswartz/resume_builder --skill debugger-reckerswartz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugger
Source: https://github.com/reckerswartz/resume_builder/tree/main/.windsurf/skills/debugger
Command: npx skills add https://github.com/reckerswartz/resume_builder --skill debugger-reckerswartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers isolate the root cause of Rails errors, failing specs, and unexpected behavior by guiding a structured, root-cause-first debugging process.

Core Features & Use Cases

  • Structured failure capture: captures exact error messages, stack traces, and reproduction steps to support precise diagnosis.
  • Guided localization: steers debugging toward the narrowest code path (controller, model, or service) and traces data flow.
  • Actionable plan: yields a concrete diagnosis, a minimal reproducible example, and a targeted fix plan with verification steps.

Quick Start

Describe a failing scenario with error details and steps to reproduce to initiate the root-cause analysis.

Frequently Asked Questions about debugger

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

FAQPage Schema
How do I find the root cause of a failing Rails spec?

Finding the root cause of a failing Rails spec requires capturing exact error messages and reproduction steps to support precise diagnosis. A structured debugging workflow isolates the narrowest code path and traces data flow to pinpoint the failure in controllers, models, services, or background jobs.

What is the best way to debug a Rails controller error with a stack trace?

The best way to debug a Rails controller error is applying a root-cause-first analysis to the stack trace. This process involves guided localization to narrow down the exact code path, document the evidence-backed reproduction steps, and generate a targeted fix plan with verification.

How do I reproduce a flaky test in Rails for bug tracking?

Reproducing a flaky test in Rails for bug tracking requires documenting exact reproduction steps and capturing the stack trace. A structured failure capture process traces the data flow through the specific model or background job to isolate the precise conditions triggering the unexpected behavior.

Can I use a structured debugging workflow for Rails background jobs?

Yes, a structured debugging workflow applies to Rails background jobs experiencing unexpected behavior. By capturing error details and tracing data flow through the job's code path, you can isolate the root cause and produce a concrete diagnosis with a minimal reproducible example.

Why does my Rails application need root-cause analysis for regressions?

Root-cause analysis is needed for Rails regressions to prevent recurring unexpected behavior. By guiding localization to the narrowest code path and yielding a targeted fix plan with verification steps, it ensures precise diagnosis rather than just patching surface-level symptoms.

What should I include in a bug report to fix Rails errors quickly?

To fix Rails errors quickly, a bug report should include exact error messages, full stack traces, and precise reproduction steps. Providing these details enables a structured root-cause-first debugging process to generate an actionable fix plan with verification.