CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/test-framework-blueprint

Use when designing a test automation framework from scratch or re-architecting one that grew organically. Walks seven steps from inventorying the app to runner, layout, fixtures, object model, data and mocks, reporting, CI and conventions, and outputs a written blueprint with a build order.

Quality

89%

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

86%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 decision workflow that is highly actionable, appropriately split across two real one-level-deep references, and free of basic-concept padding. The main improvements are removing the duplicated runner-convention advice and making the per-step checkpoints explicitly verifiable rather than just recorded.

Suggestions

State the 'prefer the existing E2E convention in package.json' guidance once (in Step 2) and have the Do-not-use entry reference it, removing the verbatim duplication that costs tokens.

Convert each step's 'Decision output' into an explicit checkpoint (e.g., 'Do not proceed to the next step until this table has a row per layer/fixture/dependency'), mirroring the verification instruction already present in Step 6.

Trim repeated inline Playwright citations to the References section and cite once at first use, keeping the Step 3 prose leaner.

DimensionReasoningScore

Conciseness

The body is dense decision guidance (tables, rules of thumb, deferral pointers) that assumes Claude's competence and never explains basics like what Playwright or fixtures are, but there is verbatim duplication — the 'when a repo already has an E2E convention in package.json, prefer continuing with it' advice appears in both the Do-not-use list and Step 2 — and a few citations are repeated. This matches anchor 4 (efficient, minor instances that could be trimmed) rather than 5 (every token earns its place).

4 / 5

Actionability

Each step ends in a concrete 'Decision output' spec, and the body includes copy-paste-ready commands and config (`reporter: [['junit', { outputFile: 'results.xml' }]]`, `npx playwright test --shard=1/4`, `npx playwright merge-reports --reporter html`, `gh run rerun <run-id> --failed`), a full directory tree, fixture-scope and object-model decision tables, and a worked example covering the common case — fully executable guidance for an instruction/decision skill.

5 / 5

Workflow Clarity

Seven steps are clearly sequenced with a per-step 'Decision output' checkpoint and a Step 6 verification instruction ('check every row has test retry 0 and distinct content'), plus a Step 7 enforcement loop. However, only Step 6 makes verification explicit; the other steps define outputs to record but no check-before-proceeding step, so it fits anchor 4 (most checkpoints present, minor validation gaps) rather than 5.

4 / 5

Progressive Disclosure

The body is a well-signaled overview that keeps deep mechanics in two clearly linked, one-level-deep reference files (fixture-mechanics.md and worked-example.md, each introduced with what it contains and when to consult it), and both referenced files exist in the bundle and link only to external docs, not to further nested files. Content is appropriately split and navigation is easy, matching the anchor 5 example.

5 / 5

Total

18

/

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 with an explicit 'Use when' trigger covering two distinct scenarios and a comprehensive enumeration of the seven design steps plus the output artifact. The only gaps are a few missing natural synonyms in the description text itself and unaddressed overlap with closely related framework skills.

DimensionReasoningScore

Specificity

"Walks seven steps from inventorying the app to runner, layout, fixtures, object model, data and mocks, reporting, CI and conventions, and outputs a written blueprint with a build order" enumerates the full set of concrete design actions plus the concrete output artifact, which is comprehensive coverage for the domain rather than just several actions with gaps.

5 / 5

Completeness

The description opens with an explicit trigger clause ("Use when designing... from scratch or re-architecting one that grew organically") and clearly states what it does (walks seven named steps, outputs a written blueprint with a build order), so both what and when are answered with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases like "designing a test automation framework from scratch", "re-architecting", and "grew organically" match what an SDET would actually say, but common synonyms such as "test harness", "test architecture", or "SDET" appear only in the metadata keywords, not the description itself. It sits above anchor 3 (relevant keywords present, variations missing) but short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Designing a test automation framework from scratch or re-architecting one that grew organically" carves a clear design-phase niche distinct from test-writing or scaffolding skills, but it shares "test framework" terminology with closely related skills (runner selection, harness scaffolding) creating minor overlap risk. It fits anchor 4 (mostly distinct, minor overlap with closely related skills) rather than 5, since the description alone doesn't separate it from those sister skills.

4 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

On this page