CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/tdd-stuck-pattern-resolver

Pattern catalog for "I can't write the test first" moments - recognizes common testability blockers (singletons / static dependencies, network in constructors, time / random as hidden inputs, deeply nested construction, untestable boundaries) and proposes the refactor that unblocks TDD (extract interface, dependency injection, seam, ports-and-adapters). Use as TDD coaching when an engineer is stuck on a class of code. For a catalog of what-to-test heuristics with no story use heuristic-test-design-reference, to label a change's shape before planning test effort use code-change-shape-classifier, and for conventions on writing the test well once the code is testable use test-code-conventions.

80

Quality

100%

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

Overview
Quality
Evals
Security
Files

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured coaching skill: lean overview, sequenced workflow with a decision tree and worked example, and three clearly-signaled reference files holding the full before/after code. It assumes competence and avoids re-teaching TDD basics.

DimensionReasoningScore

Conciseness

Lean body that defers TDD basics to Beck ('For TDD basics, defer to Kent Beck') and compresses the catalog into a table, a decision tree, a worked example, an anti-patterns table, and a short limitations section — every token earns its place and Claude's competence is assumed.

3 / 3

Actionability

Gives a concrete 7-step 'How to use', a decision tree that routes symptoms to pattern numbers, and a worked example with executable code ('processOrder(1, { findOrder: () => ({ id: 1 }) })'); the linked reference files contain complete before/after code for each pattern.

3 / 3

Workflow Clarity

The multi-step process is clearly sequenced (numbered 1-7) with a decision tree for routing and a worked example walking route -> open -> move -> test; the test written at the seam acts as the verification checkpoint, and refactoring here is incremental rather than a destructive batch operation.

3 / 3

Progressive Disclosure

The body is an overview whose pattern table links to three real, one-level-deep reference files (injection-patterns.md, boundary-adapter-patterns.md, structural-patterns.md), each covering a distinct pattern group with full before/after code — content is appropriately split and clearly signaled.

3 / 3

Total

12

/

12

Passed

Description

100%

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 precise, third-person description that names concrete blockers and refactors, leads with a natural trigger phrase, states when to use it, and cleanly differentiates three sibling skills. No fluff or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'recognizes common testability blockers (singletons / static dependencies, network in constructors, time / random as hidden inputs, deeply nested construction, untestable boundaries) and proposes the refactor that unblocks TDD (extract interface, dependency injection, seam, ports-and-adapters)'.

3 / 3

Completeness

Answers both what (pattern catalog that recognizes blockers and proposes refactors) and when ('Use as TDD coaching when an engineer is stuck on a class of code') with an explicit trigger clause.

3 / 3

Trigger Term Quality

Leads with the natural phrase an engineer would actually say — '"I can\'t write the test first" moments' — and 'when an engineer is stuck on a class of code', giving good coverage of real trigger language.

3 / 3

Distinctiveness Conflict Risk

Explicitly routes three sibling skills to distinct niches ('For a catalog of what-to-test heuristics ... use heuristic-test-design-reference, to label a change\'s shape ... use code-change-shape-classifier, and for conventions on writing the test well ... use test-code-conventions'), giving it a clear niche unlikely to conflict.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents