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 instruction-only skill body: a terse, sequenced TDD cycle with built-in validation checkpoints, an explicit feedback loop, a completion checklist, and exactly one well-signaled reference that exists and goes only one level deep. The only minor gap is the absence of any concrete example command or test snippet, which keeps actionability at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is lean and imperative ("Write the test first. Watch it fail. Write the minimal code to pass. Refactor with the tests green.") with zero padding and no re-explanation of TDD concepts Claude already knows. Every token earns its place, matching the level-5 anchor exactly.

5 / 5

Actionability

The guidance is concrete and executable — "Run the project's test command", "The test must fail because the behavior is missing, not because of a typo or a missing import", "If it passes, it tests nothing new: change the test" — with validation criteria for each step. It falls short of level 5 only because no example command or concrete test snippet is shown (justifiably project-dependent, but still a minor gap), matching the level-4 anchor; per the scoring notes, absence of code in an instruction-only skill is not penalized when guidance is actionable.

4 / 5

Workflow Clarity

The five-step cycle is clearly sequenced with explicit validation checkpoints ("Watch it fail" with failure-mode diagnosis, "Watch it pass. Run the full suite. Every test passes, with no errors or warnings", "Run the suite again" after refactor), an error-recovery feedback loop (test passes early → change the test), and a done-checklist ("Before you say it is done"). This matches the level-5 anchor: clear sequence, explicit validation, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

The body is under 50 lines, well-organized into sections (The cycle, Rules, Before you say it is done), and includes one clearly-signaled, one-level-deep reference — "read [references/writing-good-tests.md](references/writing-good-tests.md)" — which exists as a real file containing no nested references. Per the judging guidelines, a short skill with no need for external references scores 5 with just well-organized sections, and the single well-signaled reference reinforces this.

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 the complete TDD cycle concretely and provides an explicit "Use when" clause with natural trigger phrases covering features, bug fixes, and behavior changes. The only weaknesses are a few missing natural synonyms (e.g., "TDD", "unit test") and a trigger scope broad enough to slightly overlap other code-change workflow skills.

Suggestions

Add a natural synonym users say, such as "TDD" or "test-first", to the trigger clause to broaden keyword coverage.

Consider narrowing the "when" clause slightly (e.g., explicitly excluding pure refactors or documentation-only changes) to reduce overlap with other code-change workflow skills.

DimensionReasoningScore

Specificity

The description lists the complete concrete action cycle — "write one failing test, run it and watch it fail, write the minimal code to pass, then refactor with the tests green" — giving comprehensive coverage of the skill's behavior. It matches the level-5 anchor (multiple specific concrete actions, comprehensive) rather than level 4, which expects minor coverage gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the full test-first cycle and the "when" is "Use when a change alters code behavior: a new feature, a bug fix, or a behavior change". This matches the level-5 anchor (clear, explicit what AND when with concrete trigger phrases); level 4 would require the "when" to be less explicit or specific.

5 / 5

Trigger Term Quality

Natural user phrases like "a new feature", "a bug fix", and "a behavior change" are present and would be said when this skill is needed, but common synonyms such as "TDD", "red-green", or "unit test" are missing. Good keyword coverage with a few natural terms absent fits the level-4 anchor; level 5 requires synonyms and variations, and level 3 would mean the core phrases users actually say are missing, which is not the case.

4 / 5

Distinctiveness Conflict Risk

Test-driven development is a distinct methodology niche, so the skill is mostly distinguishable, but the trigger claims essentially any code-behavior change ("whether the request comes alone or through delivery-flow"), creating minor overlap risk with closely related workflow and delivery skills. This fits level 4 (mostly distinct, minor overlap risk) rather than level 5's minimal-conflict standard.

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

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