CtrlK
BlogDocsLog inGet started
Tessl Logo

test-driven-development

Use when implementing any feature or bugfix, before writing implementation code

53

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

The body is highly actionable with executable examples and an excellent, well-validated Red-Green-Refactor workflow. Its main weaknesses are redundant coverage of the same rationalizations across three sections and a broken external reference to a missing file.

Suggestions

Consolidate the rationalizations into a single section instead of repeating them across 'Why Order Matters', the 'Common Rationalizations' table, and 'Red Flags' to reduce token cost.

Create the referenced testing-anti-patterns.md (or remove the broken link) so the one-level-deep reference actually resolves.

Consider moving the extended philosophical rebuttals into a separate reference file to keep SKILL.md as a leaner overview.

DimensionReasoningScore

Conciseness

Code examples and commands are lean and it avoids explaining basic programming concepts, but the same rationalizations are covered three times (the 'Why Order Matters' prose rebuttals, the 'Common Rationalizations' table, and the 'Red Flags' list), which could be tightened.

2 / 3

Actionability

It provides fully executable TypeScript test and implementation examples, concrete commands like 'npm test path/to/test.test.ts', and copy-paste-ready Good/Bad pairs, giving specific actionable guidance throughout.

3 / 3

Workflow Clarity

The Red-Green-Refactor cycle is clearly sequenced with mandatory 'Verify RED' and 'Verify GREEN' validation checkpoints, explicit feedback loops ('Test fails? Fix code, not test.'), and a final verification checklist.

3 / 3

Progressive Disclosure

Sections are well-organized with headers (not a wall of text) and the one external link is one level deep and clearly signaled, but that reference (testing-anti-patterns.md) does not exist and no bundle directories are present, so navigation is broken and the body is largely monolithic inline content.

2 / 3

Total

10

/

12

Passed

Description

42%

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 provides an explicit and well-formed usage trigger but omits what the skill actually does (TDD / writing tests first) and uses overly generic triggers that would conflict with many skills. Tightening the what and adding test-specific trigger terms would markedly improve it.

Suggestions

Add an explicit statement of what the skill does, e.g. 'Write a failing test first, then minimal code to pass it (test-driven development).'

Include test-related trigger terms such as 'tests', 'TDD', or 'red-green-refactor' so users needing testing discipline naturally invoke it.

Narrow the trigger so it is distinguishable from general coding skills rather than firing on every feature or bugfix.

DimensionReasoningScore

Specificity

The description names the domain ('implementing any feature or bugfix') and an ordering action ('before writing implementation code') but does not list concrete skill actions like writing failing tests first, so it stops at naming the domain and some actions rather than multiple specific actions.

2 / 3

Completeness

It has a strong, explicit 'Use when...' clause covering when to use the skill, but the 'what' (test-driven development, writing tests first) is only weakly implied via the ordering phrase and never stated, so it does not clearly answer both.

2 / 3

Trigger Term Quality

'feature' and 'bugfix' are natural terms a user would say, but coverage is limited and notably omits any test/TDD-related trigger terms despite this being a testing skill, missing common variations.

2 / 3

Distinctiveness Conflict Risk

'implementing any feature or bugfix' is extremely broad and would trigger for nearly all coding work, conflicting with many other skills rather than carving out a distinct niche.

1 / 3

Total

7

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
obra/superpowers
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.