skills.rest
chloebrett
chloebrettCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

test-design-reviewer

Evaluates test suite quality against Dave Farley's eight properties of good tests.

Updated May 30, 2026
Search Tags:#tdd#code review#test quality#test suite#test review#dave farley#farley score
One-click install
npx skills add https://github.com/chloebrett/snitchos --skill test-design-reviewer-chloebrett
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-design-reviewer
Source: https://github.com/chloebrett/snitchos/tree/main/.claude/skills/test-design-reviewer
Command: npx skills add https://github.com/chloebrett/snitchos --skill test-design-reviewer-chloebrett

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Development teams often write tests that are brittle, slow, or redundant without realizing it. This Skill provides a structured, evidence-based review of test files and suites, scoring them against Dave Farley's eight properties of good tests so teams know exactly where their test quality stands and what to fix first. ## Core Features & Use Cases - Eight-Property Scoring: Rates tests on Understandable, Maintainable, Repeatable, Atomic, Necessary, Granular, Fast, and First (TDD), each on a 1-10 scale with concrete evidence. - Weighted Farley Score: Computes a single aggregate score using a documented weighting formula, with interpretation bands from Exemplary to Critical. - Actionable Recommendations: Delivers prioritized improvement suggestions with code examples, plus individual and aggregate scores when reviewing multiple files. - Use Case: After a sprint, ask for a review of your integration test suite to identify flaky or tightly coupled tests before they erode trust in CI. ## Quick Start Review the test files in my project and score them against Dave Farley's eight properties of good tests with a Farley Score breakdown.

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 the quality of my test suite?▼

Score each test file against Dave Farley's eight properties: Understandable, Maintainable, Repeatable, Atomic, Necessary, Granular, Fast, and First. This Skill rates each property 1-10 with evidence and computes a weighted Farley Score for an overall quality rating.

What are Dave Farley's properties of good tests?▼

They are eight criteria from Dave Farley's article on TDD: tests should be Understandable, Maintainable, Repeatable, Atomic, Necessary, Granular, Fast, and written First. Each property measures a distinct dimension of test effectiveness and long-term value.

How is the Farley Score calculated?▼

The Farley Score weights each property: Understandable and Maintainable at 1.5x, Repeatable at 1.25x, Atomic, Necessary, Granular, and First at 1.0x, and Fast at 0.75x, then divides the total by 9. Scores above 9.0 are Exemplary; below 3.0 is Critical.

Can this review multiple test files at once?▼

Yes. When reviewing multiple test files, the Skill provides individual scores for each file plus aggregate scores across the suite. This helps identify whether quality issues are isolated or systemic across the codebase.

What are the limitations of a test design review?▼

The review assesses test design quality, not correctness of the code under test or actual coverage metrics. TDD adherence scoring is conservative when evidence is unclear, since test-first authorship cannot always be determined from the code alone.

Related Skills

Explore More Software Engineering Skills→
Srajangpt1Srajangpt1

dev6-review-fix

Apply code review fixes, run tests, and create a git commit.

Community
Intermediate
prefactordevprefactordev
3

test-auditor

Audit test suites to classify tests as keep, revise, or remove.

Official
Intermediate
summarybotngsummarybotng
2

mutation-testing

Introduce code mutations and measure test suite kill rates.

Official
Advanced
ewe-studiosewe-studios
1

Rust Testing Excellence

Create Rust unit, integration, and property-based tests with proptest.

Official
Advanced