test-debugging-specialist

Diagnose and fix failing Vitest and Playwright tests with structured debugging.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix failing tests with a structured debugging approach.

Core Features & Use Cases

  • Guided, repeatable steps for identifying error types (assertion failures, element-not-found, timeouts), isolating test cases, and validating mock behavior across Vitest and Playwright environments.
  • Practical workflows for using console logging, breakpoints, and Playwright Inspector to reproduce and resolve issues quickly.
  • Use Case: When a test fails with unclear messages, apply the provided process to reproduce, inspect state, and restore test stability.

Quick Start

Run the failing test file in isolation and add console logging to capture context.

Frequently Asked Questions about test-debugging-specialist

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

FAQPage Schema
How do I debug failing Vitest and Playwright tests systematically?▼

Fix assertion errors and element lookup failures by reproducing the issue in isolation, inspecting the DOM or application state, and validating mock behavior. This approach works across Vitest and Playwright setups to quickly restore test stability.

Why does my Playwright test timeout when looking up an element?▼

Resolve Playwright timeouts by using the Playwright Inspector to inspect the DOM, capturing screenshots to verify element visibility, and adding console logging to trace application state during the test run.

What is the best way to isolate a failing test case from a large suite?▼

Isolate a failing test by running the specific test file independently rather than the full suite. This reduces interference, allows targeted console logging, and helps reproduce exact failure conditions quickly.

How do I verify mock behavior when a unit test fails with an unclear message?▼

Verify mock behavior by validating mock interactions and assertions directly within the isolated test run. Use console logging to output mock call data and confirm the mocked functions receive expected arguments.

Can I use this debugging approach for both unit and end-to-end test failures?▼

Yes, this systematic debugging approach applies to unit, integration, and end-to-end tests. It handles assertion errors, element lookup failures, timeouts, and mock-related issues across both Vitest and Playwright environments.