debug-tests

Categorize and fix flaky or failing Bun test suites.

6|1|Updated Apr 26, 2025
One-click install
npx skills add https://github.com/edobry/minsky --skill debug-tests-edobry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-tests
Source: https://github.com/edobry/minsky/tree/main/.claude/skills/debug-tests
Command: npx skills add https://github.com/edobry/minsky --skill debug-tests-edobry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging of test failures: categorize, isolate, and fix by category to prevent cross-problem oscillation and speed up resolution.

Core Features & Use Cases

  • 8-step debugging process: categorize failures, isolate, verify, and fix category-by-category.
  • Handles common failure types: timeouts, undefined variables, mocks, and data shape mismatches.
  • Use cases: when bun:test suites fail, or intermittent test failures occur.

Quick Start

Run the Debug Tests process on failing Bun test suites to categorize faults and apply fixes iteratively.

Frequently Asked Questions about debug-tests

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

FAQPage Schema
How do I debug flaky tests that keep timing out in Bun?

Debug flaky Bun tests by systematically categorizing timeout failures and isolating them from other issues. This process verifies timeout conditions independently before applying targeted iterative fixes to prevent cross-problem oscillation and speed up resolution.

What is the best way to fix undefined variable errors in bun:test suites?

Fix undefined variable errors in bun:test suites by categorizing them as variable naming traps and isolating the failing scope. This systematic debugging approach verifies data structure alignment before applying targeted category-specific fixes.

How do you troubleshoot mock implementation issues causing intermittent test failures?

Troubleshoot intermittent test failures from mock implementation issues by categorizing them as mock faults and isolating the behavior. This method verifies robust mock and data structure alignment checks before applying iterative fixes.

Does this systematic debugging process work for data shape mismatches in mock-heavy tests?

Yes, this systematic debugging process handles data shape mismatches in mock-heavy tests by categorizing them as data structure alignment issues. It isolates the mismatched data shapes and verifies alignment before applying targeted iterative fixes.

Why should I categorize test failures before attempting to fix my Bun test suite?

Categorize test failures before fixing your Bun test suite to prevent cross-problem oscillation. This systematic isolation and verification step ensures you apply targeted fixes category-by-category, significantly speeding up overall resolution.