CtrlK
BlogDocsLog inGet started
Tessl Logo

review-vitest-tests

Use when reviewing Vitest test files (.vitest.ts/.tsx) for quality against Positron's builder pattern, RTL patterns, and conventions. Not for e2e or Playwright tests.

73

Quality

90%

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

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.

A high-quality review skill: executable commands, quantified thresholds, a prioritized checklist with built-in validation (lint + suppression audit), and disciplined delegation of pattern catalogs to the project's rules files to prevent drift. The only weakness is minor verbosity in a few enumerations that could be trimmed without losing information.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — it never explains what Vitest or RTL is, and each checklist item is criteria plus a concrete check. Minor over-explanation could be trimmed (e.g., the enumerated jest-dom rule names in item 2 "prefer-to-have-focus, prefer-to-have-class, prefer-to-have-text-content, etc." and the full example-cast list in the wide-cast bullet). Not 5 due to those few redundant enumerations; well above 3 since nearly all content is project-specific knowledge Claude cannot infer.

4 / 5

Actionability

Fully executable guidance throughout: exact paths to read (".claude/rules/vitest-tests.md", "src/vs/test/vitest/positronTestContainer.ts"), exact commands ("npx eslint --max-warnings 0 <file>", three grep -nE patterns with regexes), quantified thresholds ("ratio exceeds 10:1", "5+ service identifiers"), accepted cleanup forms, and a concrete output format including the empty-case handling ("No issues found"). Nothing is pseudocode or vague.

5 / 5

Workflow Clarity

Clear sequence: numbered Setup (read test+source files, read rules files conditionally on .tsx, read builder JSDoc) → a per-file checklist in priority order with an explicit impact-weighting paragraph → a defined output format. Validation is built in (the required lint run with --max-warnings 0, the suppression audit, and the falsifiability mutation check), and the report-only-failures rule prevents drift. No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The skill is a single-file bundle (no references/scripts/assets) with well-organized sections, and it deliberately delegates the pattern catalogs to the rules files ("The rules files (vitest-tests.md, vitest-rtl.md) are the single source of truth; this skill intentionally doesn't duplicate lists so they can't drift"). All external references are one level deep, clearly signaled with exact paths, and the conditional read ("For any .vitest.tsx file under review, also read .claude/rules/vitest-rtl.md") is precise navigation guidance.

5 / 5

Total

19

/

20

Passed

Description

87%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 tight, well-scoped description that explicitly covers what, when, and what-not (e2e/Playwright exclusion) with concrete trigger terms and file extensions. The only gap is a thin set of synonyms for the trigger terms. Voice is correctly third-person imperative.

DimensionReasoningScore

Specificity

"reviewing Vitest test files (.vitest.ts/.tsx) for quality against Positron's builder pattern, RTL patterns, and conventions" names the domain and several concrete review lenses (builder pattern, RTL patterns, conventions) with a specific file extension, though the underlying action is a single one (review). Not 5 because it lists lenses of one action rather than multiple distinct actions; not 3 because the lenses and extension make coverage clearly beyond '1-2 concrete actions'.

4 / 5

Completeness

"Use when reviewing Vitest test files (.vitest.ts/.tsx) for quality against Positron's builder pattern, RTL patterns, and conventions" explicitly answers both what (review test files for quality against named patterns) and when (reviewing Vitest test files) with concrete trigger phrases, and adds an explicit negative scope ("Not for e2e or Playwright tests"). This matches the anchor-5 example structure (capability list + 'Use when...' clause) and beats the 4 anchor, whose 'when' is weaker than this one.

5 / 5

Trigger Term Quality

Natural terms present: "reviewing", "Vitest test files", ".vitest.ts/.tsx", plus exclusion terms "e2e or Playwright tests" that sharpen routing. Not 5 because common synonyms a user would say — "unit tests", "test suites", "test quality" — are missing; not 3 because extensions and both positive and negative triggers exceed 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"Vitest test files (.vitest.ts/.tsx)", "Positron's builder pattern", and "Not for e2e or Playwright tests" carve out a clear niche with distinct triggers and an explicit exclusion, minimizing conflict with general code-review or e2e skills. Not 4 because the extension-qualified triggers and negative scope leave little overlap risk.

5 / 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
posit-dev/positron
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.