CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd

Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious cheap local test target. Skip when the test path is unclear, expensive, integration-heavy, or not requested.

59

Quality

74%

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 ./plugins/pstack/skills/tdd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 lean, opinionated instruction-only skill with a well-sequenced workflow, explicit validation feedback loops, concrete fallbacks for impractical test paths, and clear reporting requirements. Its only weakness is minor repetition of the when-not-to-test guidance across three sections.

DimensionReasoningScore

Conciseness

Efficient and assumes Claude's competence — no basic-concept teaching — but the skip-when-impractical guidance is stated three times ('Do not force a test when it would be impractical...', 'Do not add tests when the practical signal is weak; use manual or scripted verification', 'Prefer no new test over a bad test') and could be consolidated; not a 5 due to that repetition.

4 / 5

Actionability

Concrete directives throughout ('Add the smallest focused test that would have caught the bug', 'Confirm it fails for the intended reason') plus a concrete fallback list ('targeted script, manual reproduction command, browser automation, snapshot comparison, log assertion, or focused integration check'); not a 5 because 'Run relevant adjacent tests, type checks, lint, or scenario checks' remains generic and what to do when the test still fails after the fix is left implicit.

4 / 5

Workflow Clarity

Clear 7-step sequence with explicit validation checkpoints ('Run the new test before fixing. Confirm it fails for the intended reason') and an explicit feedback loop ('If it passes or fails for an unrelated reason, correct the test or reproduction before editing the implementation'), plus rerun and adjacent-validation steps and an evidence-based final report. Not below 5: checkpoints, error recovery, and reporting are all present.

5 / 5

Progressive Disclosure

The body is under 50 lines, needs no external references, and is organized into well-signaled sections (Workflow, If a Failing Test Is Impractical, Guardrails, Final Response) — each earning its place. This meets the simple-skill exception for scoring 5 with well-organized sections and no bundle files.

5 / 5

Total

18

/

20

Passed

Description

51%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 tightly-gated, highly distinctive description with excellent explicit trigger and skip guidance, but it omits any statement of what the skill actually does, which caps both completeness and specificity. Adding a capability sentence before the use/skip conditions would lift it substantially.

Suggestions

Open with a one-sentence capability statement (e.g., 'Fixes bugs test-first: write a focused failing regression test, make the smallest fix, then verify it passes') so the what is explicit, not just the when.

Add natural trigger synonyms such as 'unit test', 'test-first', or 'write a test before fixing' to broaden natural-term coverage.

Fold the skip conditions into the use clause (e.g., 'Use when the user asks for TDD or a regression test, or the bug has an obvious cheap local test target; otherwise use the closest verification') to state both what and when in one flow.

DimensionReasoningScore

Specificity

The description names the domain ('TDD, a failing test, or a regression test', 'an obvious cheap local test target') but never states any concrete action the skill performs — no capability verb appears anywhere. Closest to 'Names the domain but actions are minimal or generic'; not a 3 because no concrete skill actions are stated.

2 / 5

Completeness

'When' is fully and explicitly covered ('Use only when... Skip when...') but the description never states what the skill does — this matches 'only when is present without what'; not a 3 because there is no clear 'what' even weakly implied, and not a 4/5 because the what-half of the question is simply absent.

2 / 5

Trigger Term Quality

Natural user phrases are present and well-chosen ('explicitly asks for TDD, a failing test, or a regression test', 'bug', 'test path'), giving good keyword coverage; not a 5 because common natural synonyms such as 'unit test', 'test-first', or 'write a test' are missing.

4 / 5

Distinctiveness Conflict Risk

The tight gating ('Use only when... OR when the bug has an obvious cheap local test target. Skip when the test path is unclear, expensive, integration-heavy, or not requested') defines a clear niche with distinct triggers and minimal conflict risk — it would not be mistaken for a general testing or debugging skill.

5 / 5

Total

13

/

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

adamsardo/pstack-claude

Path

plugins/pstack/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.