CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

test-driven-development

Implements a feature or bug fix test-first - write one failing test, watch it fail, write the minimal code to pass, then refactor with tests green. This is the implementation stage inside the delivery-flow workflow, entered by requests like "implement this feature", "fix this bug", "write the code for this", or "add the tests and implement it" once delivery-flow is driving the change. Do not activate directly for a standalone request that has not gone through delivery-flow first.

71

Quality

89%

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

81%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 highly actionable, strongly sequenced TDD discipline skill with explicit validation checkpoints, error-recovery loops, and a real, well-signaled reference file. Its main weakness is token efficiency: the no-code-without-failing-test rule is hammered across four overlapping sections with several duplicated entries.

Suggestions

Merge the 'Common Rationalizations' table and 'Red Flags' list into a single section — entries like 'Keep as reference', 'deleting is wasteful', 'TDD is dogmatic', and 'spirit not ritual' appear in both, so consolidating removes ~30 lines of duplication.

Trim the multi-sentence 'Reality' rebuttals in the Rationalizations table to one-line answers, or move the longer arguments into references/writing-good-tests.md.

Replace the graphviz digraph with a short text cycle (RED -> verify fail -> GREEN -> verify pass -> REFACTOR -> repeat) since the diagram duplicates the sequenced section headers that immediately follow it.

DimensionReasoningScore

Conciseness

Per-line the body is punchy and imperative, but the core rule is restated across four sections (Iron Law, Common Rationalizations, Red Flags, Final Rule), and several items appear near-verbatim in both the Rationalizations table and the Red Flags list ('Keep as reference', 'Deleting X hours is wasteful', 'TDD is dogmatic', 'spirit not ritual'). This systematic duplication exceeds the 'minor instances of over-explanation' of anchor 4 and fits anchor 3: mostly efficient but includes content that could be tightened.

3 / 5

Actionability

Fully executable guidance throughout: concrete TypeScript test and implementation examples, exact commands ('npm test path/to/test.test.ts'), paired Good/Bad examples, and a complete worked bug-fix example showing expected FAIL and PASS output. It is not anchor 4 because the examples cover the common cases (feature via retry, bug fix via form validation) without meaningful gaps.

5 / 5

Workflow Clarity

The RED -> Verify RED -> GREEN -> Verify GREEN -> REFACTOR -> Repeat cycle is explicitly sequenced with mandatory verification commands at each phase, error-recovery feedback loops ('Test errors? Fix error, re-run until it fails correctly'; 'Test fails? Fix code, not test'), and a pre-completion checklist. The destructive-operation cap does not apply because validation steps are present and explicit.

5 / 5

Progressive Disclosure

One reference file is clearly signaled and real ('read [references/writing-good-tests.md] for the rules that keep tests honest') with a bullet summary of its contents, one level deep — good structure. Not anchor 5 because the ~315-line SKILL.md retains substantial inline material (the rationalization rebuttal table, the graphviz cycle diagram) that arguably belongs in the reference file.

4 / 5

Total

17

/

20

Passed

Description

92%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: third-person, concrete, and complete, with natural trigger phrases and an explicit activation boundary that sharply limits conflict risk. The only gap is missing common synonyms like 'TDD' or 'test-driven development' in the trigger phrasing.

DimensionReasoningScore

Specificity

'Implements a feature or bug fix test-first - write one failing test, watch it fail, write the minimal code to pass, then refactor with tests green' enumerates the complete concrete action cycle of the skill with no gaps within its domain. It exceeds anchor 4 ('several specific actions; minor gaps in coverage') and matches anchor 5's comprehensive multi-action coverage.

5 / 5

Completeness

Explicitly answers both 'what' (the full red-green-refactor cycle with concrete actions) and 'when' ('entered by requests like... once delivery-flow is driving the change'), with concrete trigger phrases plus a do-not-activate boundary clause. This matches anchor 5 exactly.

5 / 5

Trigger Term Quality

Concrete request phrases are natural — 'implement this feature', 'fix this bug', 'write the code for this', 'add the tests and implement it' — but common synonyms a user would say, such as 'TDD', 'test-driven development', or 'write the tests first', are absent. This fits anchor 4 (good keyword coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Do not activate directly for a standalone request that has not gone through delivery-flow first' defines a clear niche (the implementation stage of the delivery-flow workflow) with explicit anti-trigger guidance, minimizing the risk of firing for standalone implementation requests that belong to other skills. Clear match for anchor 5.

5 / 5

Total

19

/

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

00-activation-testing/before/plugins/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.