CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd

Test-first at pre-agreed seams — one test, one implementation, tracer-bullet red/green; independent expected values; substitutions only at the seam's boundary class; launch Phase 4 reference.

Quality

80%

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

Quality

Content

92%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 is a tight, well-structured instruction skill: a clear test-first loop with an explicit failure-reason checkpoint, concrete rules, a defined exception path, and a concrete output contract. Its only weakness is reliance on undefined external context (C2, boundary-class records, the repair worker) that a reader outside the referenced workflow cannot resolve.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: it never explains what TDD or red/green is, and every clause carries a rule ('a test that cannot fail is not a test', 'reproduction before theory'). No padded sections or known-concept explanations to trim, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Gives concrete, executable directives ('Write the next test at a seam. Run it.', 'Implement the smallest change that turns it green', 'Substitute at the seam's declared boundary class only') plus a concrete output contract. Not a 5 because key dependencies are undefined in-skill: 'C2's approved output', 'the class C2 records', and 'the repair worker' refer to external artifacts and roles the reader must already know about.

4 / 5

Workflow Clarity

The loop is a clearly sequenced numbered workflow with an explicit validation checkpoint ('Watch it fail for the reason you expect') and a defined exception path ('If the behavior cannot be tested at any approved seam, stop and say so') with a reporting destination. Refactoring is explicitly excluded from the loop, removing ambiguity about scope.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external reference files (none exist in the bundle), and content is well-organized into clear sections (The loop, Rules, When no seam fits, Output). Per the simple-skill guideline, this satisfies the top anchor with well-organized sections alone.

5 / 5

Total

19

/

20

Passed

Description

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

The description states concrete, specific capabilities but is written in dense insider jargon with no explicit 'Use when' trigger guidance, capping completeness and trigger-term quality at the midpoint. It is distinguishable from other skills but would benefit from natural user-facing trigger phrases like 'TDD' or 'write a failing test first'.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases (e.g., 'Use when the user asks for TDD, test-driven development, or writing a failing test before implementing').

Replace or unpack insider shorthand — 'launch Phase 4 reference', 'tracer-bullet', 'boundary class' — with terms a user would actually say when they need this skill.

State the 'when' explicitly for the non-launch case (agreeing seams with the user) so both usage contexts are covered, not just implied.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'one test, one implementation', 'tracer-bullet red/green', 'independent expected values', 'substitutions only at the seam's boundary class' — but coverage is not fully comprehensive: 'launch Phase 4 reference' names no concrete action and reads as an insider pointer.

4 / 5

Completeness

The 'what' is clear (test-first loop with expected-value and substitution rules), but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'launch Phase 4 reference' only weakly implies when, which caps completeness at 3 per the judging guidelines. Not a 2 because the 'what' half is concrete and multi-part.

3 / 5

Trigger Term Quality

'test-first' and 'red/green' are phrases a user might say, but common variations like 'TDD', 'unit test', or 'write a failing test' are missing, and the description is dominated by jargon ('pre-agreed seams', 'boundary class', 'tracer-bullet') that users would not naturally say. Not the level above because keyword coverage is partial rather than good.

3 / 5

Distinctiveness Conflict Risk

The seam-disciplined test-first framing carves a mostly distinct niche unlikely to trigger for unrelated skills, though bare 'test'/'implementation' terms leave minor overlap risk with general testing skills. Not a 5 because the description lacks explicit distinct trigger phrases that separate it from neighboring test-writing skills.

4 / 5

Total

14

/

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

Yeachan-Heo/oh-my-claudecode

Path

skills/tdd/SKILL.md

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.