Is this skill compatible with my specific testing framework?

Yes, the principles are universal and apply to any testing environment, including Jest, Pytest, Cypress, Mocha, and others.

What is the meta-learning integration feature?

After fixing a bug, the skill prompts the user to document the pattern in the project's CLAUDE.md or documentation, ensuring the AI and the team learn from the failure.

How does this skill help with flaky tests?

It provides a step-by-step workflow to create minimal reproductions and isolate environmental factors, helping to identify the non-deterministic triggers behind flaky behavior.

Can this skill fix my code automatically?

It assists in the investigation and fix process by providing a logical path to the root cause, ensuring that any code changes actually address the underlying issue.

Test Debugging Workflow

Name: Test Debugging Workflow
Author: mshuffett

bymshuffett

0•

Security & Testing

Systematizes the process of identifying, reproducing, and fixing failing or flaky tests through rigorous root-cause analysis.

The Test Debugging skill provides a structured framework for resolving software test failures by moving beyond mere error reporting to deep investigation. It guides Claude through a universal five-step approach—identification, reproduction, localization, analysis, and verification—ensuring that the underlying cause is addressed rather than just the symptoms. By integrating meta-learning practices, the skill encourages documenting discovered patterns in project-specific files like CLAUDE.md, preventing future regressions and improving overall code health.

Key Features

01Systematic localization techniques to find where failures originate

02Verification checks for both individual fixes and full suite regression

03Minimal reproduction protocols to isolate complex bugs

04Root-cause analysis workflow for consistent and thorough debugging

050 GitHub stars

06Meta-learning integration to capture project-specific patterns

Use Cases

01Resolving complex integration failures after major refactors

02Investigating non-deterministic or flaky tests in CI/CD pipelines

03Standardizing debugging documentation within a development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles test-debugging

For use in Claude.ai and ChatGPT

Download Skill