CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/test-pyramid-balancer

Build-an-X workflow that analyzes a repo's test mix (unit / integration / E2E counts + runtimes) and recommends rebalancing toward the test pyramid ratios per the change-set shape - pure-logic-heavy repo wants ~80/15/5; UI-heavy repo wants ~60/25/15. Detects 'ice-cream cone' (E2E-heavy) and 'hourglass' (integration-thin) anti-patterns. Use when the user asks about test distribution, test strategy, test balance, too many E2E tests, slow CI caused by tests, testing best practices, or rebalancing their test suite; also suitable for quarterly calibration of the test mix to codebase reality.

68

Quality

85%

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

77%Weight 40%Scale 1-5

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 workflow with real validation checkpoints and a closing feedback loop. The main weaknesses are the inlined inventory script that its own comment says belongs in scripts/, and stack-specific runtime-measurement commands that assume a JavaScript toolchain.

Suggestions

Move the inventory script into an actual scripts/test-mix-inventory.py bundle file and reference it from Step 1, keeping SKILL.md as an overview (progressive_disclosure).

Make Step 2 runtime measurement stack-agnostic: give per-stack commands or a generic JUnit-XML aggregation recipe instead of assuming Jest + Playwright (actionability).

Trim the References section's Mike Cohn quotation to a one-line link and drop the hourglass fix's repetition of the Step 1 content-signal heuristics (conciseness).

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no generic test-pyramid primer), but there is minor trimmable material: the Mike Cohn quotation block in References and the hourglass fix re-explaining the content-signal hints already shown in Step 1's classifier. This matches the 4 anchor ('efficient; minor instances of over-explanation'), not the 5 anchor's 'every token earns its place'.

4 / 5

Actionability

The Step 1 classifier is executable copy-paste Python, Step 5 includes a specific grep for migration candidates and a complete output template, and Step 6 names the re-run command. The main gap is Step 2: 'time npm test' / 'npx playwright test' hardcodes a JavaScript stack with only a passing 'OR via JUnit XML aggregation' nod for other languages — mostly executable with minor gaps, matching the 4 anchor.

4 / 5

Workflow Clarity

Seven clearly sequenced steps with explicit validation checkpoints — Step 1 requires sampling 5-10 tests per bucket and reclassifying misclassified ones, Step 4 requires user confirmation before recommending large-scale test moves — plus a genuine feedback loop in Step 6 ('If any layer is still outside its target band, return to Step 4'). This matches the 5 anchor's explicit validation steps and error-recovery loops; this is an analysis/recommendation skill, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

Sections are well organized and external references (test-pyramid link, test-effort-estimation's change-shape-classifier, test-coverage-targeter, e2e-suite-budget) are clearly signaled and one level deep. However, the ~30-line inventory script is inlined in the body while labeling itself 'scripts/test-mix-inventory.py' — and no scripts/ bundle file actually exists — so content that belongs in a separate file is inline, matching the 3 anchor rather than 4.

3 / 5

Total

16

/

20

Passed

Description

88%Weight 40%Scale 1-5

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, third-person, multi-action capability statement paired with an explicit and well-populated 'Use when' clause covering both on-demand and scheduled usage. Its only weaknesses are one over-broad trigger term ('testing best practices') and a few missing natural synonyms.

Suggestions

Drop or narrow 'testing best practices' to something like 'test suite health check' to reduce false triggers against general testing-advice skills.

Add 'test pyramid', 'test layers', or 'flaky E2E tests' as trigger synonyms to catch more natural user phrasings.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'analyzes a repo's test mix (unit / integration / E2E counts + runtimes)', 'recommends rebalancing toward the test pyramid ratios per the change-set shape', and 'Detects ice-cream cone (E2E-heavy) and hourglass (integration-thin) anti-patterns' — with concrete ratio examples (~80/15/5, ~60/25/15) in third-person voice. Coverage is comprehensive, matching the 5 anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

It explicitly answers both 'what' (analyze test mix, detect anti-patterns, recommend rebalancing ratios) and 'when' via a concrete 'Use when the user asks about test distribution...' clause plus the quarterly-calibration case. This matches the 5 anchor exactly; the 4 anchor would require a less explicit 'when'.

5 / 5

Trigger Term Quality

Trigger phrases like 'test distribution, test strategy, test balance, too many E2E tests, slow CI caused by tests, or rebalancing their test suite' are natural user phrasings. However, 'testing best practices' is over-broad and likely synonyms ('test pyramid', 'flaky tests', 'test suite health') are missing, so it sits between the 4 and 5 anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

The test-mix rebalancing niche is distinct with dedicated triggers ('too many E2E tests', 'test balance'), but 'testing best practices' and 'slow CI caused by tests' create minor overlap risk with general testing-advice and CI-optimization skills — the 4 anchor's 'minor overlap risk with closely related skills'.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents