CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-loop-write-readable-tests

Plan test coverage and choose behavioral names when designing, writing, changing, or reviewing automated tests. Use for naming alone, even before implementation, and for drafting or revising a Spec Loop Test specification. Keep each test's setup, action, and expected result easy to see. General testing guidance works with or without Spec Loop.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/spec-loop-write-readable-tests/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body itself is exemplary for a pointer skill — lean, well-structured, with clearly conditioned references — but it delegates 100% of its substance to two files that are absent from the bundle, so the skill delivers no actionable test-writing guidance. Either ship the referenced files or inline the core guidance.

Suggestions

Add the referenced files (test-design-and-writing.md and spec-loop-task-verification.md) to the bundle (e.g., in a references/ directory), since the entire value of the skill depends on them and they are currently missing.

Inline a minimal core — e.g., one example of a behavioral test name and the setup/action/expected-result structure — so SKILL.md delivers guidance even when a reference cannot be loaded.

Add fallback guidance for what to do when an applicable reference file is unavailable, so the workflow does not dead-end.

DimensionReasoningScore

Conciseness

The ~20-line body is lean and every line earns its place: a two-sentence scope note, two conditionally-triggered reference pointers, and a return instruction. No explanation of concepts Claude already knows and no padding, matching the top anchor.

5 / 5

Actionability

The routing guidance is conditional and specific ("Read each applicable reference fully", "Do not load it for standalone test work"), but the actual test-design and naming guidance lives entirely in test-design-and-writing.md and spec-loop-task-verification.md, neither of which exists in the bundle — the specific steps to execute are missing. Not a 1 because the routing instructions themselves are concrete rather than abstract.

2 / 5

Workflow Clarity

As a simple router skill the single action is unambiguous: read the applicable reference(s) by condition, then "Return to the invoking workflow afterward", with explicit negative guidance for the Spec Loop-only file. Not a 5 because the central step — reading the referenced files — cannot actually be executed since neither file is present in the bundle.

4 / 5

Progressive Disclosure

The reference signaling is well-formed (one level deep, each with trigger conditions and a content preview), but scored against the actual bundle structure both referenced paths are dangling — no reference files exist anywhere in the bundle. There is no content to progressively disclose, leaving the structure non-functional rather than merely imperfect (anchor 3's 'not clearly signaled' or anchor 2's 'buried' don't apply, but the effective deliverable is as empty as the anchor-2 failure).

2 / 5

Total

13

/

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 in third-person voice that clearly states capabilities, gives explicit multi-scenario 'Use for' trigger guidance, and delimits its Spec Loop scope. Minor room to add natural synonyms (unit/integration tests) and tighten the general-testing claim that broadens conflict risk.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Plan test coverage", "choose behavioral names", "drafting or revising a Spec Loop Test specification" — covering design, writing, changing, and review. Not a 5 because the actions stay at the planning level without the comprehensiveness of concrete capability lists; not a 3 because more than 1-2 actions are named.

4 / 5

Completeness

Explicitly answers both: what ("Plan test coverage and choose behavioral names... Keep each test's setup, action, and expected result easy to see") and when ("Use for naming alone, even before implementation", "when designing, writing, changing, or reviewing automated tests", "for drafting or revising a Spec Loop Test specification"). The 'Use for' trigger guidance is explicit and covers multiple concrete scenarios, matching the top anchor; it clearly exceeds the anchor-4 example whose 'when' is generic.

5 / 5

Trigger Term Quality

Natural terms users would say are present: "test coverage", "automated tests", "naming", "writing, changing, or reviewing" tests, plus the distinctive "Spec Loop Test specification". Missing common variations like "unit tests", "integration tests", or "test names" to reach 5; well above the generic-keyword level of 3.

4 / 5

Distinctiveness Conflict Risk

The pairing of coverage planning, behavioral naming, and Spec Loop Test specifications carves a mostly distinct niche with explicit scope ("works with or without Spec Loop"). Not a 5 because "General testing guidance" keeps broad overlap risk with any generic test-writing or TDD-style skill.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

dpolivaev/spec-loop

Path

skills/spec-loop-write-readable-tests/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.