CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

author-vitest-tests

Use when writing or adding Vitest tests for Positron src/vs/ or extensions/ code, checking a branch/PR for test-coverage gaps, or testing React components with RTL.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally actionable, well-sequenced workflow skill: every step carries an exact command with its expected result, and confirmation gates plus validation loops guard the fragile operations. The only real weaknesses are mild redundancy between the Writing quality bar and the Hard rules, and the inlined subagent prompt that a reference file would absorb.

DimensionReasoningScore

Conciseness

Dense and prescriptive throughout — exact commands and file paths, with no explanations of concepts Claude already knows (never explains what Vitest or RTL are). Not 5 because the test-quality bar is stated twice (Writing section vs. Hard rules), "start low, let errors guide you up" and the don't-run-the-full-suite rule each appear twice, and the plan-confirmation rules are restated across the section.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: exact git/gh/npx commands with expected outputs ("npx tsc -p extensions/<name> --listFilesOnly | grep vitest" with "expect no output"), a concrete test-plan template with example reasoning, and complete Agent() subagent invocations. Not below 5 because the common cases (file path, branch, PR number, PR URL) are each covered with specific commands.

5 / 5

Workflow Clarity

Three phases are explicitly sequenced with skip conditions ("**Skip this phase** if the argument is a specific source file path"), mandatory confirmation gates ("stop and wait for confirmation"), validation at every step (test run, type-check "must be clean", tsconfig exclusion check, builder-enforcement grep, review subagent), and explicit feedback loops ("Iterate on missing stubs", "If the dev asks for changes, revise the plan and re-present").

5 / 5

Progressive Disclosure

Well-organized sections with clearly signaled, one-level-deep references into repo files ("Read the Testing section of CLAUDE.md", "Skim the builder JSDoc in positronTestContainer.ts", ".claude/rules/vitest-tests.md"). Not 5 because the ~50-line analysis subagent prompt is inlined in the body — content that belongs in a separate reference file the Agent call could cite; above 3 since all references are clearly signaled with their purpose.

4 / 5

Total

18

/

20

Passed

Description

78%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, third-person description with explicit trigger guidance and a clearly distinctive niche. Its main limitation is that the capability statement doubles as the trigger list, so the full workflow (analysis, authoring, independent review, verification) is only partially conveyed.

Suggestions

Add natural trigger synonyms such as "unit tests" or "test files" and the ".vitest.ts" file extension to broaden keyword coverage.

Consider a brief distinct capability phrase (e.g., "analyzes diffs, drafts test plans, and runs an independent review pass") so the 'what' is explicit rather than embedded in the 'Use when' clause.

DimensionReasoningScore

Specificity

Lists several concrete, technology-named actions — "writing or adding Vitest tests", "checking a branch/PR for test-coverage gaps", "testing React components with RTL" — scoped to "Positron src/vs/ or extensions/ code". Not 5 because the skill's other capabilities (independent test review, full-suite verification) are unmentioned; well above 3's 1-2 actions.

4 / 5

Completeness

Explicit "Use when..." clause with three concrete triggers, and the "what" is embedded in those same gerunds (write tests, analyze coverage gaps, test React components). Not 5 because the "what" is implicit rather than a distinct capability statement — the review and verification workflow is absent; above 3 since the "when" is fully explicit.

4 / 5

Trigger Term Quality

Good coverage of natural phrases users would say ("Vitest tests", "test-coverage gaps", "React components", "RTL", "branch/PR"). Not 5 because common synonyms and extensions like "unit tests", "test files", or ".vitest.ts" are missing.

4 / 5

Distinctiveness Conflict Risk

"Vitest", "Positron", "src/vs/", "extensions/", and "RTL" carve out a clear niche with distinct triggers and minimal conflict risk with any generic skill, matching the anchor exactly.

5 / 5

Total

17

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

posit-dev/positron

Path

.claude/skills/author-vitest-tests/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.