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.