CtrlK
BlogDocsLog inGet started
Tessl Logo

testing-principles

Language-agnostic testing principles including TDD, test quality, coverage standards, and test design patterns. Use when writing tests, designing test strategies, or reviewing test quality.

73

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exceptionally tight, well-structured principles skill: every section is a specific, directive rule set, the TDD cycle provides an explicitly validated workflow, and the single-file organization is appropriate for its size. The only improvement surface is adding one or two brief worked examples (e.g., a sample test name or table-driven case) to lift actionability to fully concrete.

DimensionReasoningScore

Conciseness

The body is lean and directive — dense one-line rules such as 'RED: confirm the new test fails for the intended reason. GREEN: implement the smallest passing change.' with zero padding and no explanation of concepts Claude already knows. Every token carries guidance, matching the 'lean and efficient; every token earns its place' anchor; it is not a 4 because there are no trimmable over-explanations anywhere.

5 / 5

Actionability

Concrete, executable directives are present throughout — 'Add a regression test for every reproducible behavior bug fix', 'Mock direct external I/O boundaries; keep internal business logic and the boundary under test real', 'Structure each test as Arrange, one Act, and Assert'. It is not a 5 because, per the instruction-only scoring note, fully actionable guidance for common cases would include at least one worked example (e.g., a named test or a table-driven case); it is above a 3 because the guidance is specific and directly executable, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

The TDD section is a clearly sequenced cycle with explicit validation checkpoints and feedback loops: RED ('confirm the new test fails for the intended reason' — a failure-reason check), GREEN, REFACTOR ('while the test remains green'), and VERIFY ('run the repository's applicable regression checks'). The refactor path adds a precondition loop ('first confirm existing tests pass... then refactor and rerun the same regression evidence'), matching the anchor-5 sequence-with-explicit-validation pattern.

5 / 5

Progressive Disclosure

At ~52 lines with eight well-organized sections (TDD, Quality Requirements, Test Design Rules, Mock and Boundary Rules, Data Layer Testing, Verification Requirements, Test Organization, Regression Testing), no external references are needed and none are buried — the simple-skill case where well-organized sections alone warrant a 5. No bundle files exist, so there are no nested or buried references to penalize.

5 / 5

Total

19

/

20

Passed

Description

87%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 clause and a clear enumeration of the skill's coverage areas. Its main gap is stylistic: it names topics rather than actions, which keeps specificity and trigger coverage a notch below the best examples.

DimensionReasoningScore

Specificity

The description lists several specific capability areas — 'TDD, test quality, coverage standards, and test design patterns' — giving concrete coverage of the domain. It falls short of a 5 because these are topic nouns rather than the concrete actions (verbs like 'Extract', 'Generate') that top anchors demonstrate, and it stays just below comprehensive.

4 / 5

Completeness

It explicitly answers both: what ('Language-agnostic testing principles including TDD, test quality, coverage standards, and test design patterns') and when ('Use when writing tests, designing test strategies, or reviewing test quality') with concrete trigger phrases. Not 4 because the 'when' clause is already explicit and specific, not merely present-but-improvable.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: 'writing tests', 'designing test strategies', 'reviewing test quality', plus 'TDD' and 'coverage'. A few natural terms are missing — e.g., 'unit tests', 'test suite', 'testing' itself as a bare trigger — so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (testing principles, explicitly scoped 'language-agnostic') with distinct triggers tied to test-writing and test-review situations. The only adjacent surface is 'reviewing test quality' touching a general code-review skill, which is minimal conflict risk, matching the anchor-5 fit rather than the 'minor overlap risk with closely related skills' anchor 4.

5 / 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.

Repository
shinpr/claude-code-workflows
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.