CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

56

Quality

71%

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 ./.agents/skills/tdd/SKILL.md

The canonical home for this skill is tdd in mattpocock/skills

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.

A well-structured, opinionated process skill with a clear workflow and genuinely useful anti-pattern guidance (horizontal vs vertical slices). Two real weaknesses: the Philosophy section re-explains testing basics Claude already knows, and every external reference in the body is a broken link to files that don't exist in the bundle.

Suggestions

Create the referenced files (tests.md with good/bad test examples, mocking.md with the mocking guidelines, refactoring.md with refactor candidates) or remove the links and inline the essential content — as written, all three are dead references.

Cut the Philosophy section to the project-specific opinion (integration-style tests through public interfaces, no implementation coupling) and drop the general explanation of why implementation-coupled tests break under refactor.

Add error-recovery guidance to the workflow: what to do when a new test passes immediately (it isn't testing anything new) or when minimal code doesn't reach GREEN.

DimensionReasoningScore

Conciseness

The Philosophy section spends roughly three paragraphs explaining good-vs-bad testing concepts Claude already knows (implementation coupling, tests surviving refactors, mocking internals) before reaching the skill-specific opinion. The rest of the body is lean and directive. Matches anchor 3 ('mostly efficient but includes some unnecessary explanation') rather than 4 because the padding is confined to a whole section, and rather than 2 because only that one section over-explains.

3 / 5

Actionability

Concrete, instruction-level guidance throughout: planning checklists with user-approval gates, an exact question to ask ('What should the public interface look like?'), explicit RED→GREEN cycle rules, a per-cycle checklist, and a concrete pointer to run the /codebase-design skill. Minor gaps keep it below anchor 5 — no test-framework or command specifics and the RED→GREEN blocks are schematic rather than executable. Anchor 4 ('mostly executable guidance... minor gaps') fits; this is acceptable for an instruction-only skill per the scoring notes.

4 / 5

Workflow Clarity

Clear four-phase sequence (Planning → Tracer Bullet → Incremental Loop → Refactor) with explicit checkpoints: each test must fail then pass, 'Never refactor while RED', and 'Run tests after each refactor step', plus checklists. Not anchor 5 because there is no error-recovery/feedback-loop guidance (e.g. what to do when the new test never goes RED, or when minimal code doesn't reach GREEN); stronger than anchor 3 because validation states are explicit rather than implicit.

4 / 5

Progressive Disclosure

The body links to [tests.md](tests.md), [mocking.md](mocking.md), and [refactoring.md](refactoring.md), but none of these files exist in the bundle — there is no references/, scripts/, or assets/ directory. Scored against the actual bundle structure per the judging guidelines, the claimed one-level-deep split is undelivered and navigation dead-ends. Anchor 2 fits (structure present in intent but effectively non-functional); anchor 3 would require working but poorly signaled references.

2 / 5

Total

13

/

20

Passed

Description

70%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 solid description with an explicit and natural trigger clause ('Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests'). Its main weakness is the thin 'what' — it relies on the methodology's name rather than describing the concrete actions the skill performs. Third-person voice is used correctly.

Suggestions

Expand the 'what' clause with concrete actions, e.g. 'Write one failing test at a time, implement minimal code to pass it, then refactor — building features vertically rather than in bulk.'

Add common trigger synonyms such as 'TDD', 'write tests first', or 'unit testing' alongside the existing 'red-green-refactor' and 'integration tests'.

DimensionReasoningScore

Specificity

Names the domain ('Test-driven development') and gestures at actions ('build features or fix bugs test-first') but lists no concrete skill actions such as write-failing-test, implement, refactor. Not score 4 because there is no list of several specific actions; not score 2 because the actions named are not purely generic.

3 / 5

Completeness

Both 'what' and 'when' are present, with an explicit 'Use when...' clause carrying concrete triggers, but the 'what' is a bare noun phrase ('Test-driven development.') with no elaboration of the actions performed. Matches anchor 4 ('when' explicit, 'what' present but thinner than the anchor-5 multi-action formulation).

4 / 5

Trigger Term Quality

Includes natural user phrases — 'build features', 'fix bugs', 'test-first', 'red-green-refactor', 'integration tests'. Falls short of anchor 5 because common synonyms like 'TDD', 'write tests first', and 'unit testing' are missing; better than anchor 3 because several natural trigger terms are covered.

4 / 5

Distinctiveness Conflict Risk

'Test-driven development' plus 'test-first', 'red-green-refactor', and 'integration tests' carves a distinct niche, but the broad lead-in 'build features or fix bugs' creates minor overlap risk with general coding skills if the 'test-first' qualifier is missed. Anchor 4 ('mostly distinct; minor overlap risk with closely related skills') is the best fit.

4 / 5

Total

15

/

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: 3 missing

Warning

Total

15

/

16

Passed

Repository

coder/agent-tty

Path

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