CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd

TDD loop, one vertical slice at a time (red, green, refactor). Trigger: test-first development, TDD.

61

Quality

77%

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 ./ywai/skills/tdd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A tight, opinionated methodology skill with concrete directives, a clear loop sequence, and a genuine seam-confirmation checkpoint. Its two weaknesses are the missing red-phase validation step and two dead references to unbundled files (tests.md, mocking.md) that break progressive disclosure.

Suggestions

Bundle tests.md and mocking.md alongside SKILL.md (or remove the links) — both references in 'What a good test is' point to files that do not exist in the skill directory.

Add an explicit red-phase verification step, e.g. "Run the test and confirm it fails for the expected reason before writing any implementation", plus what to do if it unexpectedly passes.

Trim the opening meta-narrative ("This skill is the reference that... consult them before and during the loop, not after") to a single sentence, and cut the restatement of basic test doctrine in 'What a good test is'.

DimensionReasoningScore

Conciseness

The body is lean and sectioned, with only minor trimmable material: the opening meta-narrative ("This skill is the reference that makes that loop produce tests worth keeping... consult them before and during the loop, not after") and restated known wisdom ("Tests verify behavior through public interfaces, not implementation details"). Not 5 because a few sentences explain concepts Claude already knows; not 2-3 because there is no padded section and most tokens carry non-obvious judgment (the anti-pattern "tells", the pre-agreed-seams rule).

4 / 5

Actionability

Concrete, executable guidance throughout: "write down the seams under test and confirm them with the user", a literal question to ask ("What's the public interface, and which seams should we test?"), a worked tautology example ("expect(add(a, b)).toBe(a + b)"), and an explicit tool invocation ("call the Skill tool with 'codebase-design'"). Not 5 because there is no inline example of a good test or a full red-green cycle — those are deferred to files that are not in the bundle, leaving minor gaps.

4 / 5

Workflow Clarity

The loop is clearly sequenced ("Red before green. Write the failing test first, then only enough code to pass it", "One slice at a time") with one explicit checkpoint ("No test is written at an unconfirmed seam"). Not 5 because the core TDD validation — run the test and confirm it fails for the expected reason before implementing — is implied rather than stated, and there is no recovery guidance for when the failing test unexpectedly passes; not 3 because sequence and checkpoints are mostly present with only minor gaps.

4 / 5

Progressive Disclosure

Sections are well organized and the two external references are clearly signaled and one level deep ("See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines"), but neither tests.md nor mocking.md exists in the bundle (no references/ directory), so the navigation chain is broken. Not 4 because references must resolve to real files; not 2 because the inline content is appropriately structured rather than bulk that belongs elsewhere.

3 / 5

Total

15

/

20

Passed

Description

73%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 concise, distinctive description with an explicit trigger clause covering both natural terms for TDD. Its main limitation is specificity: it names the loop but not the skill's broader content (test quality, seams, anti-patterns), and the trigger clause could name more user scenarios.

DimensionReasoningScore

Specificity

"TDD loop, one vertical slice at a time (red, green, refactor)" names the domain and the loop's concrete phases, but does not mention the skill's other coverage (test-quality criteria, seams, anti-patterns, loop rules). It sits at "names domain and 1-2 concrete actions, but not comprehensive" rather than 4, which requires several listed actions, and above 2 because the phases named are concrete rather than generic.

3 / 5

Completeness

Explicit what ("TDD loop, one vertical slice at a time (red, green, refactor)") and explicit when ("Trigger: test-first development, TDD."), so the missing-trigger cap at 3 does not apply. Not 5 because the when-clause is terse and lacks concrete scenario phrasing (e.g., "when the user asks to implement a feature test-first").

4 / 5

Trigger Term Quality

"Trigger: test-first development, TDD." includes both primary natural phrases a user would say. It falls short of 5's comprehensive synonym coverage (no "write tests first", "red-green", "unit-test first") but exceeds 3's "some relevant keywords but missing common variations" since both dominant terms are present.

4 / 5

Distinctiveness Conflict Risk

"test-first development, TDD" are unambiguous niche triggers with minimal conflict risk; the body even delegates refactoring to a separate skill, further reducing overlap. No neighboring anchor fits better — 4's "minor overlap risk with closely related skills" is not evidenced.

5 / 5

Total

16

/

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

YoizenSA/dev-ai-workflow

Path

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