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 exemplary lean SKILL.md body: a crisp five-step cycle with genuine validation checkpoints and no token waste. Its single real defect is navigation — the bundled reference writing-good-tests.md is never linked from the body, so a reader of SKILL.md alone would never discover it.

Suggestions

Link the existing reference from the body, e.g. under a "Writing good tests" note: "When writing the test itself, follow [writing-good-tests.md](references/writing-good-tests.md)" — the file currently sits in the bundle unreferenced.

Consider a one-line pointer for when deep guidance applies (mocks, expected values, cleanup helpers), mirroring the reference's own 'Load this reference when' header, so the trigger is discoverable from SKILL.md.

DimensionReasoningScore

Conciseness

The body is 11 lines with no padding and no explanation of concepts Claude already knows (it never explains what TDD or testing is); every token earns its place, matching the "lean and efficient" anchor.

5 / 5

Actionability

Each step is a concrete, executable directive with the key details specified — "Use a clear name and the real code, not mocks", "The test must fail because the behavior is missing, not because of a typo or a missing import", "Add nothing the test does not need". Per the scoring note, absence of code in an instruction-only skill is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The five steps are clearly sequenced with explicit validation checkpoints and feedback loops: verify the failure is for the right reason (step 2), confirm the test isn't vacuous ("If it passes, it tests nothing new: change the test"), and run the full suite after both green and refactor (steps 4-5).

5 / 5

Progressive Disclosure

The body itself is well-organized, but the bundle contains references/writing-good-tests.md (~200 lines of test-writing guidance with mock/assertion rules) that the body never mentions — a reference that is present in the bundle but not signaled from SKILL.md, matching the anchor "references present but not clearly signaled". The under-50-line exception doesn't apply cleanly because an external reference exists and is orphaned.

3 / 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 that explicitly states both what it does (the full test-first cycle) and when to use it (any behavior-altering change), in third person with concrete actions. Its only weaknesses are missing common trigger synonyms ("TDD", "test-driven", "unit tests") and the vague "delivery-flow" term.

Suggestions

Add natural trigger synonyms users would say, e.g. "test-driven development (TDD)", "write the tests first", or "unit/integration tests", which are currently absent.

Replace or explain the jargon term "delivery-flow" with plain language such as "whether the request arrives directly or as part of a larger task".

DimensionReasoningScore

Specificity

The description lists the complete TDD cycle as concrete actions — "write one failing test, run it and watch it fail, write the minimal code to pass, then refactor with the tests green" — which is comprehensive coverage within its domain, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

It explicitly answers both questions: what ("Implements a feature or bug fix test-first: write one failing test... refactor with the tests green") and when ("Use when a change alters code behavior: a new feature, a bug fix, or a behavior change"), with concrete trigger phrases — the exact shape of the anchor-5 example.

5 / 5

Trigger Term Quality

Natural phrases like "a new feature, a bug fix, or a behavior change" are present and would be said by users, but common synonyms such as "TDD", "test-driven", or "unit tests" are missing, and "delivery-flow" is internal jargon — good coverage with a few natural terms missing, so a 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The test-first methodology is a clear niche distinct from other skills, but the trigger fires on any change that alters code behavior, which is broad enough to overlap with general coding and code-review skills — mostly distinct with minor overlap risk.

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

03-ablation/versions/cycle-only/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.