CtrlK
BlogDocsLog inGet started
Tessl Logo

tdd-workflow

Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.

57

Quality

65%

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

Quality

Content

56%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 skill delivers a clear, well-sequenced TDD workflow with concrete commands and executable test patterns. Its main costs are token bloat from standard testing knowledge Claude already has and a monolithic structure that inlines pattern libraries and CI configuration that belong in reference files.

Suggestions

Trim or remove the sections teaching knowledge Claude already has — 'Best Practices', 'Common Testing Mistakes to Avoid', and the generic Button/Playwright pattern examples — keeping only project-specific conventions.

Move the test pattern libraries (unit/integration/E2E examples), mocking recipes, and CI/CD integration into references/ files (e.g., references/patterns.md, references/mocking.md) and keep SKILL.md as the workflow overview with one-level-deep pointers.

Add error-recovery feedback loops to the workflow steps: what to do when tests still fail after implementation, and how to proceed when the 80% coverage threshold is not met.

DimensionReasoningScore

Conciseness

The ~400-line body pads heavily with material Claude already knows: a Button component Jest example, Playwright test patterns, Supabase/Redis/OpenAI mock boilerplate, a 'Best Practices' list (one assert per test, arrange-act-assert, descriptive test names), and 'Common Testing Mistakes' (don't test internals, avoid brittle selectors) — all standard testing knowledge. The core TDD workflow and coverage thresholds are the only genuinely additive parts. It is noticeably verbose with several padded sections, though not the continuous prose-explanation wall of level 1.

2 / 5

Actionability

Mostly executable: concrete commands (npm test, npm run test:coverage), a jest coverageThreshold JSON block, CI YAML, and complete unit/integration/E2E test patterns. However, the core workflow steps themselves contain stub placeholders ('// Test implementation', 'export async function searchMarkets(query: string) { // Implementation here }'), which keeps it below fully copy-paste-ready.

4 / 5

Workflow Clarity

The 7-step TDD workflow (journeys → generate tests → run and confirm failure → implement → run and confirm pass → refactor → verify coverage) is a clearly sequenced red-green-refactor loop with explicit checkpoints at steps 3, 5, and 7. It lacks error-recovery guidance (what to do when tests still fail after step 5, or coverage falls short at step 7), so it does not reach the full feedback-loop coverage of 5.

4 / 5

Progressive Disclosure

No bundle files exist and the entire ~400 lines live in SKILL.md. Section headers are good and navigation within the file is easy, but substantial content that belongs in separate reference files is inlined — the test pattern libraries, mocking recipes, and CI/CD integration (~250 lines). This matches 'some structure, but content that should be separate is inline'.

3 / 5

Total

13

/

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-formed description with an explicit 'Use when...' trigger clause and a clear statement of what the skill enforces, including quantified coverage requirements. Its main weakness is that the trigger conditions span nearly all development activity, creating overlap risk with any general coding skill.

Suggestions

Narrow the activation triggers or add testing-specific trigger phrases (e.g., 'when asked to write or verify tests', 'when setting coverage thresholds') to reduce overlap with general coding skills.

List the concrete actions the skill performs (e.g., 'writes failing tests first, implements code to pass them, verifies 80%+ coverage') to strengthen specificity beyond the single 'enforces' verb.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests" — with useful specifics (the 80% threshold, the three test types), but it lists a single enforcement verb rather than several distinct concrete actions. It is not the generic domain-only level of 2, but it falls short of the several-action coverage of 4.

3 / 5

Completeness

It explicitly answers both questions: what ("Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests") and when ("Use this skill when writing new features, fixing bugs, or refactoring code") with three concrete trigger phrases. This matches the anchor-5 example pattern of a clear what plus an explicit 'Use when...' clause.

5 / 5

Trigger Term Quality

"when writing new features, fixing bugs, or refactoring code" provides natural phrases users would actually say. Missing common variations such as "implement", "add functionality", "debug", or explicit trigger terms like "write tests" or "test coverage", which keeps it below the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The what (TDD enforcement with coverage thresholds) is a distinct niche, but the trigger clause covers essentially all development work — writing features, fixing bugs, and refactoring — so it would fire on nearly any coding request and overlap with general coding skills. It is somewhat specific, not the very-broad level of 2, but carries real overlap risk.

3 / 5

Total

15

/

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
affaan-m/ECC
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.