CtrlK
BlogDocsLog inGet started
Tessl Logo

tdd

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

63

Quality

74%

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 udecode/plate

SKILL.md
Quality
Evals
Security

Quality

Content

70%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-crafted instructional skill: the workflow is a model of sequenced validation with checklists and feedback loops, and guidance is concrete throughout. The weaknesses are duplicated guidance (DI shown twice, restated bullet lists) and a monolithic single-file layout where the specialized Type Testing section should be split into a referenced file.

Suggestions

Merge the 'Mocking' dependency-injection example and the 'Interface Design for Testability' item 1 into a single section — they demonstrate the same pattern with near-identical code (processPayment vs processOrder).

Trim the 'Characteristics of good tests' and 'Red flags' bullet lists, or fold them into the GOOD/BAD code comments — the code examples already make both points, so the lists are largely restatement.

Move the Type Testing section (utilities, positive/negative assertions, tips) into a references/type-testing.md file and keep a 2-3 line pointer in SKILL.md so the main file stays focused on the red-green-refactor loop.

DimensionReasoningScore

Conciseness

The body avoids re-teaching basics and is mostly distilled, but the dependency-injection guidance is demonstrated twice (processPayment in Mocking, processOrder in Interface Design for Testability), and the 'characteristics of good tests' / 'red flags' bullet lists restate what the GOOD/BAD code comments already convey. Anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') fits; anchor 4 would require only minor trims rather than this level of duplication.

3 / 5

Actionability

Concrete TypeScript examples, a runnable command ("bun typecheck"), explicit per-cycle checklists, and a complete RED/GREEN bug-fix walkthrough give mostly executable guidance. Not anchor 5 because examples reference undefined helpers (createCart, product, paymentMethod), so they are illustrative rather than copy-paste ready.

4 / 5

Workflow Clarity

Planning → Tracer Bullet → Incremental Loop → Refactor is clearly sequenced, with explicit validation checkpoints ("run test → confirm it FAILS correctly", "confirm it PASSES"), error-recovery guidance ("Test errors (not assertion failure)? Fix the error first"), a per-cycle checklist, and the "Never refactor while RED" guard. This matches anchor 5: explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The file has clear section headers and no nested-reference problem, but at ~320 lines with zero bundle files, specialized content sits inline — notably the ~60-line Type Testing section (Expect/Equal utilities, @ts-expect-error placement), which is a distinct advanced subtopic that belongs in a separate reference file. Anchor 3 ('content that should be separate is inline') fits; the good sectioning keeps it above anchor 2.

3 / 5

Total

15

/

20

Passed

Description

78%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 clearly states what the skill does and gives an explicit, multi-trigger 'Use when' clause built from phrases users would naturally say. The main gaps are a thin action list in the 'what' portion and one trigger (integration tests) that risks firing on non-TDD testing requests.

DimensionReasoningScore

Specificity

Names the domain ("Test-driven development") and one concrete process ("red-green-refactor loop") but does not enumerate several specific actions like write-failing-test, minimal implementation, refactor. Fits anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') better than anchor 4, which expects a list of several specific actions.

3 / 5

Completeness

Explicitly answers what ("Test-driven development with red-green-refactor loop") and when ("Use when user wants to build features or fix bugs using TDD, mentions 'red-green-refactor', wants integration tests, or asks for test-first development") with concrete trigger phrases. This matches the anchor-5 example structure exactly; it is not anchor 4 because the 'when' clause is explicit and specific rather than merely serviceable.

5 / 5

Trigger Term Quality

Includes natural phrases users actually say — "using TDD", "mentions 'red-green-refactor'", "wants integration tests", "asks for test-first development" — giving good keyword coverage. A few natural variants (e.g. "write the tests first", "unit tests") are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The TDD niche is clear with distinct triggers ("red-green-refactor", "test-first"), but the trigger "wants integration tests" could fire on general testing requests that do not intend TDD, creating minor overlap with generic testing skills. Mostly distinct with minor overlap risk — anchor 4 — rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

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
udecode/plate
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.