CtrlK
BlogDocsLog inGet started
Tessl Logo

testable-design

Design code for testability using boundary isolation, dependency injection, and testable architecture patterns. Use when designing test strategies, writing unit tests, improving test coverage, refactoring untestable or hard-to-test code, working with mocking or test doubles, or applying TDD practices.

68

Quality

83%

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

75%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-structured, actionable skill body with concrete TypeScript examples, executable search commands, a sequenced workflow with per-step outputs, and verified one-level-deep references. It falls just short of top marks due to placeholder code bodies in some examples, no error-recovery loop in the workflow, and some overlap between body content and reference files.

Suggestions

Replace placeholder comment bodies ("// Logic using this.repo", "// Business logic here") in the DI and Humble Object examples with minimal real logic so every snippet is copy-paste executable.

Add a short error-recovery note after the Step 5 checklist (e.g., what to do when a boundary check fails) to close the feedback-loop gap in workflow_clarity.

Move the three external book links out of "Related Patterns" into a separate "Further Reading" section, and trim body sections that duplicate content in the references/ files.

DimensionReasoningScore

Conciseness

The body is efficient — no re-explanation of concepts Claude already knows, tight BAD/GOOD anti-pattern pairs, and purposeful Quick Commands — but the before/after code examples carry some redundancy and could be trimmed slightly. Fits the 'efficient; minor instances that could be trimmed' anchor rather than the 'every token earns its place' anchor.

4 / 5

Actionability

Provides mostly executable guidance: complete Stub/Mock/Fake implementations, a concrete DI before/after template, and copy-paste rg commands. However several snippets have placeholder bodies ("// Logic using this.repo", "// Business logic here"), which keeps it below fully copy-paste ready.

4 / 5

Workflow Clarity

Five steps are clearly sequenced, each with an explicit "Output:" statement, and Step 5 ends in a verification checklist — but there is no feedback loop for what to do when a check fails, so it sits just below the anchor requiring explicit error-recovery loops. This is a design/refactoring skill, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

Four real, one-level-deep reference files under references/ are clearly signaled with labeled links, and the body is well sectioned. Minor gaps: body sections duplicate topics the reference files cover (e.g. "Tests Are Architecture"), and external book links are loosely appended under the "Related Patterns" heading rather than their own section.

4 / 5

Total

16

/

20

Passed

Description

91%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 that clearly states both capabilities and explicit trigger conditions with excellent natural keyword coverage. The only weaknesses are a slightly generic opening action ("Design code for testability") and minor trigger overlap with sibling testing skills.

DimensionReasoningScore

Specificity

Names the domain and several concrete techniques ("boundary isolation, dependency injection, and testable architecture patterns") rather than vague actions, but the opening "Design code for testability" is general and techniques like layer isolation or the Humble Object pattern are left uncovered.

4 / 5

Completeness

Explicitly answers both what ("Design code for testability using boundary isolation, dependency injection, and testable architecture patterns") and when ("Use when designing test strategies, writing unit tests, ... applying TDD practices") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Comprehensive natural phrasing users would actually say — "test strategies", "unit tests", "test coverage", "untestable or hard-to-test code", "mocking or test doubles", "TDD practices" — including synonyms (untestable/hard-to-test, mocking/test doubles) and the TDD abbreviation.

5 / 5

Distinctiveness Conflict Risk

Testable-design is a fairly clear niche with distinct triggers, but "writing unit tests", "improving test coverage", and "applying TDD practices" could also fire for a dedicated unit-testing or TDD skill, creating minor overlap risk with closely related skills.

4 / 5

Total

18

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.