CtrlK
BlogDocsLog inGet started
Tessl Logo

test-driven-development

在实现任何功能或修复 bug 时使用,在编写实现代码之前

52

Quality

60%

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/test-driven-development/SKILL.md
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 skill is highly actionable with an excellently sequenced, validated workflow, but it is padded with repetitive persuasion prose and ships a dangling reference to a non-existent file. Trimming the argumentation and adding the missing testing-anti-patterns.md would lift both weak dimensions.

Suggestions

Create references/testing-anti-patterns.md (or remove the '@testing-anti-patterns.md' reference) so the cited bundle material actually exists.

Condense the '为什么顺序很重要', '常见借口', and '危险信号' sections — much of their content is redundant and the same points recur across all three; keep one concise version.

Trim the repeated 'sunk cost / delete the code' argumentation to a single statement so the body respects the token budget while preserving the iron rule.

DimensionReasoningScore

Conciseness

The body mixes tight instructional material (Good/Bad examples, the cycle) with large persuasion sections ('为什么顺序很重要', '常见借口', '危险信号') that restate the same points and pad the token budget; it is mostly efficient but could be tightened substantially.

2 / 3

Actionability

Concrete executable TypeScript Good/Bad examples, real 'npm test path/to/test.test.ts' commands, and a copy-paste-ready bug-fix walkthrough provide fully actionable guidance.

3 / 3

Workflow Clarity

The red-green-refactor cycle is explicitly sequenced with mandatory verification checkpoints ('必须执行. 绝不跳过'), clear error-recovery feedback ('测试失败了?修改代码,不是测试'), and a completion checklist.

3 / 3

Progressive Disclosure

The body is well-organized into clear sections, but it references '@testing-anti-patterns.md' which does not exist in any bundle directory (references/scripts/assets are absent) — a broken one-level reference that prevents a 3.

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 a clear 'when' trigger but omits the 'what' and is too generic to be distinctive, making it read more like a usage condition than a capability statement. It needs a concrete action clause (e.g., 'write failing tests before implementation') and narrower trigger terms.

Suggestions

Lead with the concrete action, e.g. 'Write failing tests before implementation code (TDD). Use when implementing features or fixing bugs, before writing the production code.'

Add distinguishing trigger terms users actually say — 'TDD', 'test-driven', 'red-green-refactor', 'write tests first' — to separate it from general development skills.

Make the 'what' explicit so Claude can tell this skill apart from other build/development skills that would match the same generic trigger.

DimensionReasoningScore

Specificity

Names the domain ('实现任何功能或修复 bug') and a coarse action ('在编写实现代码之前') but does not enumerate multiple concrete capabilities, matching the 'names domain and some actions but not comprehensive' anchor.

2 / 3

Completeness

It answers 'when' clearly ('在实现任何功能或修复 bug 时...在编写实现代码之前') but never states 'what' the skill does (enforce test-driven-development discipline), so it fails the both-what-and-when bar for a 3.

2 / 3

Trigger Term Quality

Terms like '功能', 'bug 修复', '实现代码' are natural enough a user might say them, but coverage of common variations is thin — there are no trigger synonyms such as '测试', 'TDD', '重构', or '新功能开发'.

2 / 3

Distinctiveness Conflict Risk

'Use when implementing any feature or fixing a bug' is extremely broad and would plausibly trigger for almost any development skill, matching the 'very generic; would conflict with many skills' anchor.

1 / 3

Total

7

/

12

Passed

Validation

81%

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

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

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