CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

testing-principles

Language-agnostic testing principles for choosing which tests a change needs, test quality, and proof ownership, including frontend and browser E2E tests. Use when writing tests, deciding test scope, or reviewing test quality.

Quality

84%

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

The canonical home for this skill is testing-principles in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 lean, well-structured principles document that assumes competence, defers implementation detail to well-signaled one-level-deep references, and provides concrete directives throughout. The main gaps are the absence of worked examples to ground the abstract rules (proof boundaries, oracle independence) and an implicit rather than explicit workflow sequence.

Suggestions

Add one short good-vs-bad test example to ground the abstract actionability rules, e.g., an implementation-derived oracle vs an independently derived literal expectation.

Make the implicit workflow order explicit (select scope → choose proof boundary → design test → mock boundaries → verify), tying the verification checkpoints to those steps.

Trim the three-sentence motivational intro in the opening paragraph to one sentence and split the overloaded Test Selection bullet about proof boundaries into two rules.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no basic-concept explanations ("Structure each test as Arrange, one Act, and Assert" is used without defining the pattern), assuming Claude's competence. Minor trimmable content remains: the three-sentence motivational intro ("A brittle, duplicated, or implementation-shaped test therefore becomes a false requirement…") and a few overloaded multi-clause sentences in Test Selection, so it does not quite reach "every token earns its place".

4 / 5

Actionability

Gives concrete, executable directives such as "Mock direct external I/O boundaries; keep internal business logic and the boundary under test real" and "Add a regression test for every reproducible behavior bug fix". As an instruction-only skill code absence is not penalized, but no worked examples (e.g., a good-vs-bad test) are provided and the Capability Probe Postconditions section is terse, leaving minor gaps versus fully actionable coverage.

4 / 5

Workflow Clarity

Sections follow a coherent implicit order — Test Selection, Design Rules, Mock/Boundary, Data Layer, Verification, Organization, Regression — and validation checkpoints are present ("Capability Probe Postconditions", schema-source verification requirements). The sequence is never made explicit as a first-then flow and checkpoints are scattered rather than tied to steps, which fits anchor 4 better than anchor 5's explicit validate-fix-retry loops; no destructive/batch cap applies.

4 / 5

Progressive Disclosure

The body is a clear overview, and both referenced files (references/frontend.md, references/e2e.md) exist, are one level deep with no further nesting, and are well-signaled with explicit read-when triggers ("read when writing, changing, or reviewing component, hook, or UI integration tests"). Domain-specific implementation detail is appropriately split into the reference files, matching the anchor-5 example.

5 / 5

Total

17

/

20

Passed

Description

83%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 that explicitly states what the skill covers and when to use it, with concrete trigger phrases and mostly specific capability language. Its main weakness is abstract phrasing ("test quality", "proof ownership") and missing common trigger synonyms like "unit tests" or "test coverage".

DimensionReasoningScore

Specificity

Lists several concrete actions — "choosing which tests a change needs", "deciding test scope", "reviewing test quality" — and scopes coverage to "frontend and browser E2E tests". Not a 5 because "test quality" and "proof ownership" are abstract nouns rather than concrete actions, leaving minor gaps.

4 / 5

Completeness

Explicitly answers both: the "what" ("Language-agnostic testing principles for choosing which tests a change needs, test quality, and proof ownership") and the "when" with three concrete trigger phrases ("Use when writing tests, deciding test scope, or reviewing test quality"). It clearly fits the anchor-5 example pattern rather than anchor 4, whose "when" is less specific.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "writing tests", "test scope", "reviewing test quality", "browser E2E tests". A few natural terms are missing, such as "unit tests", "integration tests", and "test coverage", so it does not reach comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The testing niche is clear with distinct triggers ("writing tests", "test scope"), giving minimal conflict with unrelated skills. Minor overlap risk remains with closely related code-review or debugging skills via "reviewing test quality", keeping it below anchor 5.

4 / 5

Total

17

/

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.

Repository

shinpr/claude-code-workflows

Path

dev-skills/skills/testing-principles/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.