test-diagnostics

Profile Vitest test files in monorepos to detect slow, hanging, and failing tests.

6|3|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/jamesaphoenix/tx --skill test-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-diagnostics
Source: https://github.com/jamesaphoenix/tx/tree/main/.claude/skills/test-diagnostics
Command: npx skills add https://github.com/jamesaphoenix/tx --skill test-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profile all test files in a monorepo to identify slow, hanging, or failing tests.

Core Features & Use Cases

  • Per-file diagnostics to surface flaky tests and timeouts.
  • Quick triage guidance to prioritize fixes and improve test reliability.
  • Works with Vitest-based workflows across monorepos and CI pipelines.

Quick Start

Run the diagnostics script on the repository to generate a test-health report.

Frequently Asked Questions about test-diagnostics

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

FAQPage Schema
How do I profile slow tests in a Vitest monorepo?

To profile slow tests in a Vitest monorepo, run a diagnostics script that executes per-file test profiling to detect slow, hanging, and failing test runs. This surfaces performance bottlenecks and flaky tests for triage.

What is the best way to detect flaky tests across a monorepo?

Detecting flaky tests across a monorepo requires running per-file diagnostics that identify hanging and failing tests. This approach surfaces timeouts and reliability issues, providing quick triage guidance to prioritize fixes.

How do I identify which test files are causing CI pipeline bottlenecks?

Identify CI pipeline bottlenecks by profiling all test files individually to detect slow, hanging, and failing tests. The generated test-health report highlights performance bottlenecks and flaky tests for targeted fixes.

Can I use this test profiling approach with existing Vitest workflows?

Yes, this test profiling approach works directly with Vitest-based workflows across monorepos and CI pipelines. It implements a script that runs per-file diagnostics without requiring additional dependencies.

How do I generate a test-health report for triage and fixes?

Generate a test-health report by running the diagnostics script on your repository. The script profiles all test files to surface flaky tests, timeouts, and performance bottlenecks, providing quick triage guidance to prioritize fixes.