test-doctor

Diagnoses a failing test and applies a five-step workflow to restore correctness.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/vperreard/Mathildanesth --skill test-doctor-vperreard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-doctor
Source: https://github.com/vperreard/Mathildanesth/tree/main/.claude/skills/test-doctor
Command: npx skills add https://github.com/vperreard/Mathildanesth --skill test-doctor-vperreard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Test Doctor provides a disciplined, surgical approach to diagnosing and repairing broken tests, reducing guesswork, regressions, and wasted debugging time.

Core Features & Use Cases

  • Guided 5-step workflow: ISOLATE, CLASSIFY, CONSULT, FIX, VALIDATE, ensuring fixes are minimal and validated one issue at a time
  • Pattern-driven learning: reads project-specific patterns and documentation to rapidly identify root causes and reusable fixes
  • Safe learning loop: enriches patterns and creates reusable helpers to accelerate future fixes while maintaining safety
  • Scalable with multi-agent orchestration: supports parallel fixes on large modules while preserving zero-regression guarantees

Quick Start

Invoke Skill("test-doctor") on a failing test file and follow the five-step workflow to fix it with four-level validation.

Frequently Asked Questions about test-doctor

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

FAQPage Schema
How do I diagnose why a Jest test is failing?▼

To diagnose failing tests, follow a structured workflow: isolate the broken test, classify the root cause, consult project patterns, apply a minimal fix, and validate against a checklist to prevent regressions.

What is the best way to fix broken RTL tests without causing regressions?▼

The best way to fix broken RTL tests without regressions is to apply surgical fixes one at a time and validate them against a four-level checklist. This ensures changes are minimal and correctness is restored before reporting success.

Does this automated QA diagnosis approach work with parallel test fixes?▼

Yes, this automated QA diagnosis approach supports multi-agent orchestration for parallel fixes on large modules. It scales across multiple files while preserving zero-regression guarantees through isolated validation workflows.

How do I create reusable helpers for failing test automation?▼

You create reusable helpers for failing test automation by leveraging pattern-driven learning during the fix workflow. As tests are diagnosed and repaired, the system enriches project-specific patterns and generates helpers to accelerate future fixes safely.

Why should I isolate one failing test at a time during automation debugging?▼

You should isolate one failing test at a time during automation debugging to ensure fixes are surgical and validated. Operating strictly on a single test prevents cascading regressions and guarantees minimal code changes restore correctness.