Content
92%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |