CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/test-design-scorecard

Scores test files 1 to 5 on six design axes (AAA phase separation, single-responsibility, naming, fixture coupling, magic literals, setup time) using explicit per-level anchors that settle what separates a 2 from a 4, then turns the scores into growth-framed feedback and a per-author trend report; the per-PR and per-author rollup examples and trend-reporting conventions live in references/. Owns the scoring and the write-up only: the conventions being scored live in a separate conventions catalog such as `test-code-conventions`, and block-or-approve gating belongs to an adversarial review. Use when a test diff needs a graded coaching read rather than a merge verdict: onboarding a new engineer, a team deliberately ramping up test discipline, or a quarterly per-author trend where the output is a conversation, not a gate.

75

Quality

94%

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 thorough, highly actionable scoring rubric with explicit anchors, tiebreakers, a worked example, and a clean one-level-deep split of rollup/trend reporting into a verified reference file. Its one weakness is conciseness: several axis introductions restate basic testing concepts (AAA, Assertion Roulette) that Claude already knows.

Suggestions

Trim the quoted definitions of basic concepts Claude already knows (e.g. the Arrange-Act-Assert sentence and the Assertion Roulette description) to a one-line citation; keep the source link and spend the words on the anchor distinction instead.

Compress the per-axis grounding preamble so each axis opens directly with its anchor table and tiebreaker; the citations can sit as footnotes rather than multi-line block quotes.

The 'Axes deliberately excluded', 'Limitations', and 'Anti-patterns' sections overlap on the gating/not-a-gate point — consolidate the repeated 'never a merge gate' framing into one place to cut tokens without losing the message.

DimensionReasoningScore

Conciseness

Mostly efficient and well-organized, but the axis intros restate concepts Claude already knows — e.g. 'Arrange: Set up the object to be tested. Act: Act on the object... Assert: Make claims about the object' and a multi-sentence quote on Assertion Roulette — which is tighter than the verbose 'explains concepts Claude knows' 1-anchor but does not meet the 'lean; every token earns its place' 3-anchor. The bulk (anchor tables, tiebreakers, worked example, anti-patterns) earns its place; the grounding prose around basic AAA/assertion patterns could be trimmed. It is not a 1 because the core content is concrete rubric material, not generic fluff.

2 / 3

Actionability

Provides per-level anchor tables, executable tiebreaker procedures ('count the Acts', 'hide the body and read the name alone'), a copy-paste-ready worked example output, exact arithmetic steps, and an explicit banned-words/marker list — matching 'fully executable... specific examples; copy-paste ready'. Per the rubric's code-vs-instruction note, absence of code is not penalized for an instruction-only skill when guidance is this actionable. It is not a 2 because the guidance is complete and specific rather than pseudocode-like or missing key details.

3 / 3

Workflow Clarity

The 'How to use' section is a clear 6-step sequence with explicit guardrails ('Mark unmeasurable axes n/a rather than guessing', 'Confirm this is a coaching read, not a gate'), a worked example, and checklists via the Feedback rules and Anti-patterns tables, matching 'clear sequence with explicit validation steps; checklists'. It is not a 2 because checkpoints are explicit (n/a handling, axis-count printing, the 2-vs-4 tiebreaker loop) rather than implicit.

3 / 3

Progressive Disclosure

Core scoring and feedback live inline while the aggregation/reporting conventions are split into a real one-level-deep reference, referenced twice and well-signaled via links to references/trend-and-rollup-reporting.md (verified to exist). This matches 'clear overview with well-signaled one-level-deep references'. It is not a 2 because the split is appropriate and the reference is clearly signaled rather than buried.

3 / 3

Total

11

/

12

Passed

Description

100%

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 dense, well-structured description that answers what, when, and what-it-does-not-own, with concrete enumerated actions and natural scenario triggers. Third-person voice is used throughout and the boundary against sibling skills is explicit.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Scores test files 1 to 5 on six design axes (AAA phase separation, single-responsibility, naming, fixture coupling, magic literals, setup time)', 'turns the scores into growth-framed feedback and a per-author trend report' — matching the 'lists multiple specific concrete actions' anchor. It is not a 2 because the actions are enumerated comprehensively rather than named only in part. Third-person voice ('Scores...') is correct.

3 / 3

Completeness

Explicitly answers both what (scores files 1-5 on six axes, produces growth-framed feedback and a trend report) and when (an explicit 'Use when...' clause with three concrete scenarios), matching the 'clearly answers both what AND when with explicit triggers' anchor. It is not a 2 because the when is explicit, not merely implied.

3 / 3

Trigger Term Quality

The 'Use when...' clause names natural scenario phrases users would say — 'onboarding a new engineer', 'a team deliberately ramping up test discipline', 'a quarterly per-author trend', 'a test diff needs a graded coaching read rather than a merge verdict'. These are concrete, natural triggers, matching 'good coverage of natural terms users would say'. It is not a 2 because common scenario variations are covered, not just one generic keyword.

3 / 3

Distinctiveness Conflict Risk

Explicitly carves its niche and delegates the rest — 'Owns the scoring and the write-up only: the conventions being scored live in a separate conventions catalog such as test-code-conventions, and block-or-approve gating belongs to an adversarial review.' This makes it unlikely to trigger for the wrong skill, matching the 'clear niche with distinct triggers' anchor. It is not a 2 because the boundary against sibling skills is stated outright rather than merely implied.

3 / 3

Total

12

/

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