test-design-reviewer

Evaluate test quality using Dave Farley's eight properties.

710|89|Updated Nov 14, 2021
One-click install
npx skills add https://github.com/citypaul/.dotfiles --skill test-design-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-design-reviewer
Source: https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/test-design-reviewer
Command: npx skills add https://github.com/citypaul/.dotfiles --skill test-design-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to evaluating test quality by applying Dave Farley's eight properties, turning theoretical QA principles into actionable guidance for teams.

Core Features & Use Cases

  • Structured evaluation: scores tests on Understandable, Maintainable, Repeatable, Atomic, Necessary, Granular, Fast, and First.
  • Guided improvements: offers concrete, evidence-backed recommendations to raise test quality.
  • Use Case: a team reviewing a test suite for a new feature can quickly identify gaps and prioritize refactors.

Quick Start

Run the Farley review on your test suite using the agent's guidance. Provide your test files or project path and let it generate a Farley Score with actionable recommendations.

Frequently Asked Questions about test-design-reviewer

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

FAQPage Schema
How do I evaluate test suite quality using Farley's eight properties?

You can evaluate test suite quality by scoring tests against Farley's eight properties: Understandable, Maintainable, Repeatable, Atomic, Necessary, Granular, Fast, and First. The review generates a structured Farley Score with per-property evidence and concrete improvement recommendations.

What is Dave Farley's approach to assessing test maintainability and repeatability?

Dave Farley's approach assesses test maintainability and repeatability by checking if tests are easy to understand, deterministic, and isolated. This structured evaluation identifies gaps in test quality and prioritizes refactors for new features.

How do I review a TDD codebase for early test-driven design signals?

To review a TDD codebase for early test-driven design signals, provide your test files or project path to evaluate the First property. This detects early test-driven design signals and delivers evidence-backed recommendations to raise overall test quality.

Can I use this test review method on individual test files or does it require the entire project?

You can use this test review method on individual test files or entire test suites across TDD-focused codebases. It evaluates understandability, maintainability, repeatability, atomicity, necessity, granularity, speed, and early test-driven design signals at both levels.

What is the best way to identify which tests need refactoring in a software project?

The best way to identify which tests need refactoring is to generate a Farley Score that evaluates tests against eight quality properties. This structured evaluation highlights specific gaps and offers concrete, evidence-backed recommendations to prioritize refactors.

Why does my test suite score low on atomicity and granularity?

Your test suite scores low on atomicity and granularity because tests may be testing multiple behaviors simultaneously or running at an inappropriate scope. The review evaluates these specific properties, provides evidence from your codebase, and recommends targeted improvements.