Test Quality Inspector

Inspect unit and E2E tests for intent, setup, execution, and assertion quality.

146|31|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/bobmatnyc/claude-mpm --skill test-quality-inspector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Test Quality Inspector
Source: https://github.com/bobmatnyc/claude-mpm/tree/main/src/claude_mpm/skills/bundled/testing/test-quality-inspector
Command: npx skills add https://github.com/bobmatnyc/claude-mpm --skill test-quality-inspector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Engineers often write tests that pass but do not validate the intended behavior. This Skill guides you through a structured inspection of unit and end-to-end tests to confirm they test the right behavior, provide meaningful coverage, and catch real regressions.

Core Features & Use Cases

  • Intent Verification: Assess test names, descriptions, and scopes to ensure they express behavior, not implementation.
  • Setup & Execution Review: Check test data realism, fixtures, and integration points.
  • Assertion Strength Evaluation: Map assertions to intent and verify coverage of failure scenarios and edge cases.
  • Regression Readiness: Identify red flags that could miss regressions and suggest improvements.

Quick Start

Read a test file, analyze each test's purpose, verify that assertions align with expected behavior, and generate concrete improvement suggestions for stronger tests.

Frequently Asked Questions about Test Quality Inspector

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

FAQPage Schema
How do I identify weak assertions in my unit tests?

Weak assertions fail to validate intended behavior and miss regressions. Test Quality Inspector evaluates each assertion against test intent, checking whether it covers failure scenarios, edge cases, and behavior boundaries rather than just implementation details. Map assertions to your test purpose and verify they would catch real bugs.

What makes a test pass but not actually verify behavior?

Tests can pass while missing critical behavior validation due to vague intent, unrealistic test data, improper mocks, or assertions that check implementation rather than outcomes. Test Quality Inspector inspects test names, setup realism, execution paths, and assertion strength to surface these gaps before QA sign-off.

How do I reduce false negatives in my test suite?

False negatives occur when tests pass despite regression. Test Quality Inspector identifies red flags in intent clarity, fixture realism, mock configuration, and assertion coverage that allow regressions to slip through, then provides actionable recommendations to strengthen regression detection.

Can I use test inspection for both unit and end-to-end tests?

Yes. Test Quality Inspector applies a structured inspection framework to unit and E2E tests equally, analyzing intent, setup, execution, and assertions across diverse scenarios. The same principles—behavior validation, setup realism, assertion strength—apply regardless of test scope.

What should I check before QA sign-off on test coverage?

Before QA sign-off, inspect test names and descriptions for behavior clarity, verify test data reflects real conditions, confirm assertions map to intended behavior, and check for missing negative tests and edge cases. Test Quality Inspector guides this structured review to ensure tests catch actual regressions.

How do I improve tests without rewriting them from scratch?

Test Quality Inspector generates concrete improvement suggestions by analyzing existing tests for vagueness, weak assertions, missing negative tests, and improper mocks. Focus recommendations on assertion strength, setup realism, and behavior coverage rather than wholesale rewrites.