CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

test-driven-development

Implements a feature or bug fix test-first: write one failing test, run it and watch it fail, write the minimal code to pass, then refactor with the tests green. Use when a change alters code behavior: a new feature, a bug fix, or a behavior change, whether the request comes alone or through delivery-flow.

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 exemplarily lean process skill: the red-green-refactor loop is clearly sequenced with explicit validation checkpoints, a feedback loop, and a completion checklist, while test-writing detail is correctly pushed to one well-signaled reference file. The only gap is the absence of a concrete example test command in the body itself.

Suggestions

In step 2, name one concrete way to determine the test command (e.g., 'use the project's test script or README, e.g. npm test / pytest') so the step is executable in unfamiliar projects.

DimensionReasoningScore

Conciseness

The ~30-line body never explains concepts Claude already knows; every line instructs ("Write one test for one behavior... use the real code, not mocks"; "Add nothing the test does not need"). Lean and efficient with every token earning its place; not 4 because there is no over-explanation left to trim.

5 / 5

Actionability

Steps are specific and directive ("The test must fail because the behavior is missing, not because of a typo or a missing import"), and test-writing detail is concretely delegated to the reference file. However, "Run the project's test command" gives no concrete command or way to find one — mostly executable guidance with a minor gap; matches 4, not 5 (nothing is copy-paste ready).

4 / 5

Workflow Clarity

The five-step Red/Green/Refactor sequence has explicit validation checkpoints ("Watch it fail", "Watch it pass", "Run the suite again"), a feedback loop for error recovery ("If it passes, it tests nothing new: change the test"), and a final checklist ("Before you report the work as done"). Matches the 5 anchor exactly; not 4 because checkpoints and recovery are explicit rather than implicit.

5 / 5

Progressive Disclosure

The body is a concise, well-sectioned overview with a single clearly signaled, one-level-deep reference — "When writing or changing a test, read references/writing-good-tests.md" — and the bundle confirms that file exists (198 lines) with no nested references inside it. Not 4: navigation is unambiguous and nothing that belongs in the reference is inlined.

5 / 5

Total

19

/

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: it states what the skill does as a concrete four-step action sequence and provides an explicit 'Use when' clause with concrete triggers. The minor weaknesses are missing natural synonyms ('TDD', 'unit test') and a broad when-clause that could overlap other development-process skills.

Suggestions

Add natural trigger synonyms such as 'TDD', 'test-driven development', or 'unit tests' to the 'Use when' clause so users naming the methodology directly still match.

Replace or gloss the internal jargon 'delivery-flow' (e.g., 'whether asked directly or as part of a delivery workflow') — it is not a phrase a user would naturally say.

DimensionReasoningScore

Specificity

The description lists four concrete, sequenced actions — "write one failing test, run it and watch it fail, write the minimal code to pass, then refactor with the tests green" — comprehensively covering the entire red-green-refactor workflow. Not 4: there are no minor gaps in the action coverage.

5 / 5

Completeness

"Implements a feature or bug fix test-first: write one failing test..." clearly answers what, and "Use when a change alters code behavior: a new feature, a bug fix, or a behavior change" explicitly answers when with concrete trigger phrases. Not 4: the when-clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural trigger terms are present ("a new feature, a bug fix, or a behavior change"), but common synonyms users would say — "TDD", "test-driven", "unit test" — are absent, and "delivery-flow" is internal jargon no user would naturally say. Matches the 4 anchor (good coverage, a few natural terms missing); not 5 because synonym coverage is not comprehensive.

4 / 5

Distinctiveness Conflict Risk

The test-first methodology ("write one failing test", "refactor with the tests green") carves a clear niche, but the when-clause ("a new feature, a bug fix, or a behavior change") matches nearly any code change, creating minor overlap risk with general development-workflow skills. Mostly distinct with minor overlap — matches 4; not 5 because the trigger conditions are broad.

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.

Repository

tesslio/tessl-eval-demo

Path

06-regression/versions/reworded/sdlc-implementation/skills/test-driven-development/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.