review-tests

Identify test coverage gaps against feature specs and propose surface tests.

11|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/thrawn01/claude-dotfiles --skill review-tests-thrawn01
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: review-tests
Source: https://github.com/thrawn01/claude-dotfiles/tree/main/skills/review-tests
Command: npx skills add https://github.com/thrawn01/claude-dotfiles --skill review-tests-thrawn01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps verify that a feature's existing tests actually cover the acceptance criteria, scenarios, and correctness constraints described in its PRD, tech spec, and user stories, and then surfaces any remaining gaps for surface-testing. It coordinates gap-finding sub-agents and a validator to reveal incomplete test coverage and to guide follow-up testing work.

Core Features & Use Cases

  • Compare specs (PRD/tech spec/user stories) to the repository's tests and identify coverage gaps.
  • Spawn parallel sub-agents to inspect test files, ADRs, and documentation, and to propose concrete surface tests for uncovered criteria.
  • Persist a machine-parseable HTML coverage report and track history to detect regressions across runs.

Quick Start

Provide the feature directory path (or rely on the default docs paths) to start the review of test coverage against the specification.

Frequently Asked Questions about review-tests

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

FAQPage Schema
How do I check if my existing tests cover the acceptance criteria in a PRD?โ–ผ

To check test coverage against acceptance criteria, you need a gap analysis comparing spec files like prd.md and user-stories.md to the repository's test suite. This process identifies uncovered criteria and proposes surface tests to close those gaps.

What is spec coverage gap analysis and how does it work?โ–ผ

Spec coverage gap analysis is the process of comparing feature specifications against existing tests to find missing scenarios. It works by inspecting test files and documentation to assess coverage, then proposing concrete surface tests for uncovered criteria.

How do I generate surface tests for untested user stories?โ–ผ

Generating surface tests for untested user stories involves comparing user-stories.md to the test suite to find gaps, then proposing and generating targeted tests. This yields a structured plan including a criteria checklist and recommended tests.

Can I audit test coverage using my tech spec and PRD files?โ–ผ

Yes, you can audit test coverage using tech spec and PRD files by pointing the review process to the feature directory. It locates tech-spec.md, prd.md, and CONTEXT.md to derive criteria and assess whether existing tests cover the specified constraints.

How do I track test coverage regressions across multiple runs?โ–ผ

Tracking test coverage regressions across multiple runs requires persisting a machine-parseable HTML coverage report after each audit. This historical tracking detects regressions by comparing previous coverage states to the current assessment.

Do I need a specific test framework to perform a spec coverage audit?โ–ผ

No specific test framework is required, but the repository must contain a test suite and documentation files like prd.md and user-stories.md. The audit process inspects the existing tests and documentation to find coverage gaps independently of the framework.