CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/test-suite-health-audit

Measures an existing test suite's current state on four axes: per-file tier classification (unit / integration / E2E, first match wins), pyramid ratio against whatever target the team already committed to, per-layer flake rate, and defects-caught-per-run-minute ROI per tier, then reduces them to one categorical verdict (Healthy, Needs pruning, Needs refactor, Cannot assess). Reports severity against a target ratio but never prescribes one: choosing the target unit:integration:E2E mix and the rebalancing plan belongs to a pyramid-balancing capability such as `test-pyramid-balancer`. Use when a suite has grown for a year or more without review and someone needs a defensible read on whether it is healthy, over-grown, or structurally inverted before deciding what to delete or rewrite.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill with a clear five-step workflow, explicit validation/abstain gates, and a properly signaled single-level reference that exists on disk. The main weakness is verbosity: several convention justifications run longer than the marginal value they add to a competent model.

Suggestions

Tighten the multi-paragraph justifications of the 10/25-point ratio cuts and the 2/5/15% flake bands into one or two sentences each; the per-band reasoning can live in examples.md alongside the other conventions.

Avoid repeating the same Fowler/Vocke and Fowler/TestPyramid citations across Steps 1, 2, and 4; cite each source once at its most load-bearing claim and leave the index to the References section.

Trim the repeated 'do not convert this into a recommendation' and 'keep the last section even when it feels redundant' meta-commentary to a single boundary statement, since the boundary is already established in the opening ownership table.

DimensionReasoningScore

Conciseness

The body is accurate and well-organized but spends many tokens arguing for its own conventions (e.g. the multi-paragraph justifications of the 10/25-point cuts and the 2/5/15% flake bands) and restates the source citations repeatedly. It is mostly efficient but could be tightened without losing the load-bearing reasoning.

2 / 3

Actionability

Concrete executable guidance throughout: explicit tier matching rules with path strings and import names ('Path contains e2e/, cypress/, playwright/... or imports @playwright/test'), a precise ROI formula 'roi(layer) = defects_caught(layer) / total_run_minutes(layer)', and a fully specified output template. The instruction is specific enough to apply directly.

3 / 3

Workflow Clarity

Five clearly sequenced steps with first-match-wins ordering, an explicit 'Cannot assess' gate (under 3 files, confidence <80%, no target), and validation feedback ('If no per-run history exists, this axis emits not assessed and the audit continues'; 'name the specific input that would unlock it'). Checkpoints and error-recovery paths are explicit.

3 / 3

Progressive Disclosure

The body is a well-organized overview and offloads the bulky worked examples to a real one-level-deep reference, signaled as '[references/examples.md](references/examples.md)'. The reference file exists and matches the link, and navigation is clearly signaled with no nested indirection.

3 / 3

Total

11

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete four-axis measurement scope, explicit what-and-when, and sharp boundary language that prevents overlap with sibling capabilities. Trigger phrasing is situational rather than keyword-rich, which is the only weak point.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'per-file tier classification (unit / integration / E2E, first match wins)', 'pyramid ratio against whatever target the team already committed to', 'per-layer flake rate', and 'defects-caught-per-run-minute ROI per tier', then 'reduces them to one categorical verdict'. These are four specific, named measurements plus the reduction step, matching the multiple-concrete-actions anchor.

3 / 3

Completeness

It explicitly answers both: what it does ('Measures an existing test suite's current state on four axes...') and when to use it ('Use when a suite has grown for a year or more without review and someone needs a defensible read...'). Both halves are present and explicit, matching the score-3 anchor.

3 / 3

Trigger Term Quality

It contains natural terms a user might say ('test suite', 'healthy, over-grown, or structurally inverted', 'delete or rewrite'), but the trigger framing is a long situational clause rather than crisp keyword variations like 'test pyramid', 'flake rate', 'test suite health'. Coverage is relevant but not the breadth of common variations that would earn a 3.

2 / 3

Distinctiveness Conflict Risk

It carves a clear niche and explicitly names what it does NOT own ('choosing the target... belongs to a pyramid-balancing capability such as test-pyramid-balancer'), making it unlikely to fire for the related balancing or change-shape skills. This is a clear niche with distinct triggers.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents