CtrlK
BlogDocsLog inGet started
Tessl Logo

tdd-workflow

Test-Driven Development workflow for autonomous coding. Use when implementing features with TDD, writing tests first, following red-green-refactor, or ensuring test coverage.

54

Quality

68%

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

Quality

Content

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

The body leads with genuinely useful, executable API examples that match the bundled scripts, but roughly half its length is padding that re-explains TDD fundamentals Claude already knows. Validation checkpoints exist only as diagram captions, and two of the four referenced resources are missing from the bundle.

Suggestions

Remove the ASCII TDD-cycle diagram and the 'TDD Principles' / 'Test Types' tables — they restate concepts Claude already knows and consume ~60 lines of context for no new information.

Make validation explicit and actionable: state what to check at each phase (e.g., 'confirm the new test fails before implementing'; 'if GREEN fails, fix implementation not the test') and reference the error-recovery loop concretely.

Create the referenced references/TDD-BEST-PRACTICES.md and references/TEST-PATTERNS.md files, or remove the References section — the links currently point to files that do not exist in the bundle.

DimensionReasoningScore

Conciseness

Three substantial sections re-teach TDD basics Claude already knows: a ~40-line ASCII box diagram of RED/GREEN/REFACTOR/VERIFY, a 'TDD Principles' table ('Tests First', 'Minimal Code', 'Small Steps', 'Fast Feedback', 'Refactor Often'), and a 'Test Types' table explaining unit/integration/E2E tests. That is several padded sections of unnecessary explanation, matching the 2 anchor; the Quick Start and phase snippets themselves are lean, so it is not a 1.

2 / 5

Actionability

The Quick Start and 'Individual Phases' snippets are real Python against the bundled module's actual API ('from scripts.tdd_workflow import TDDWorkflow', 'implement_feature', 'write_test', 'implement_code', 'refactor' — all exist in scripts/tdd_workflow.py), not pseudocode. Minor gaps keep it from 5: 'project_dir' and 'criteria' are undefined, top-level 'await' is not copy-paste runnable, and there is no CLI usage for users who want to run the scripts directly.

4 / 5

Workflow Clarity

The RED → GREEN → REFACTOR → VERIFY sequence is clearly presented, but validation is implicit rather than actionable: checkpoints appear only as captions inside the box diagram ('Test must fail', 'Keep tests passing') with no explicit feedback-loop steps (e.g., what to do when the RED test unexpectedly passes or GREEN fails). This matches the 3 anchor 'checkpoints missing or implicit' and falls short of the 4 anchor's 'most checkpoints present'.

3 / 5

Progressive Disclosure

Section structure is good with a clear Quick Start and one-level-deep references, but the two referenced files ('references/TDD-BEST-PRACTICES.md', 'references/TEST-PATTERNS.md') do not exist in the bundle — they are dangling pointers that dead-end navigation. The script listings are accurate (all four files exist), so this sits at the 3 anchor 'references present but' not reliably navigable rather than the 2 anchor's inlined-content problem.

3 / 5

Total

12

/

20

Passed

Description

75%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 well-constructed description with an explicit 'Use when...' trigger clause and multiple natural keywords including the TDD abbreviation. Its main weakness is a thin 'what' clause that names the domain and methodology rather than enumerating concrete capabilities.

Suggestions

Strengthen the 'what' clause with concrete deliverables (e.g., 'Generates failing tests, drives minimal implementations, refactors, and runs acceptance verification') rather than restating the methodology name.

Add common trigger synonyms such as 'test-first development' or 'unit test coverage' to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'implementing features with TDD, writing tests first, following red-green-refactor, or ensuring test coverage' — beyond just naming the domain. It is not a 5 because the actions describe methodology steps rather than concrete deliverables, and the 3 anchor ('1-2 concrete actions') undersells the coverage.

4 / 5

Completeness

Both parts are present: a 'what' ('Test-Driven Development workflow for autonomous coding') and an explicit 'Use when...' clause with concrete triggers. It is not a 5 because the 'what' clause is a one-line domain statement rather than the concrete capability enumeration seen in the 5 anchor; it is clearly above the 3 anchor since the 'when' is explicit and multi-triggered.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'Test-Driven Development', 'TDD', 'writing tests first', 'red-green-refactor', 'test coverage' — phrases a user needing this skill would naturally say. Missing some common variations (e.g., 'test-first development', 'unit tests'), so it falls short of the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The TDD framing ('red-green-refactor', 'writing tests first') carves out a fairly distinct niche with specific triggers. Minor overlap risk remains with generic testing/coverage skills on terms like 'test coverage', keeping it just below the 5 anchor's 'clear niche with minimal conflict risk'.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
fernandezbaptiste/Skrillz
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.