Content
67%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 highly actionable, well-structured reference: nearly every option has executable copy-paste commands, the preferred-tool-to-fallback ordering is explicit, and edge cases (integration tests, stale build output) are flagged. The main defects are the bloated, self-repetitive --workers paragraph and the conceptual-only runTests example.
Suggestions
Rewrite the --workers section as short bullet points and remove the verbatim repetition ('because every worker loads all test files of the run. Every worker loads all test files of the run...'), or move its edge-case details to a reference file.
Replace the runTests 'Example (conceptual)' with a concrete invocation showing the files/testNames parameters, and show the --runList input file format alongside its existing example.
Add an explicit post-run verification cue for the shell path (e.g. check the Mocha summary line for executed-test counts), mirroring the validation loop already present for the runTests tool.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most sections are lean command-plus-note pairs, but the --workers section is a ~200-word single paragraph that even repeats itself verbatim ('because every worker loads all test files of the run. Every worker loads all test files of the run and runs the files it claims'). This matches anchor 3 — mostly efficient but includes unnecessary explanation that could be tightened — rather than anchor 4's 'minor instances'. | 3 / 5 |
Actionability | Every shell option ships a copy-paste-ready command (e.g. './scripts/test.sh --run src/vs/editor/test/common/model/model.test.ts --grep "should split lines"'), covering the common cases. It falls short of anchor 5 only because the runTests section is explicitly 'Example (conceptual)' with no literal invocation, and the --runList file format is never shown. | 4 / 5 |
Workflow Clarity | The decision flow is clear and ordered (prefer runTests; fall back to platform scripts; satisfy the compilation prerequisite first) and includes one explicit validation loop ('If discovery is unavailable, pending, or reports no executed tests, treat the request as unvalidated and use the repository's configured test command'). Minor gaps — no explicit verify-tests-ran step for the shell path — keep it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | With no bundle files, the single SKILL.md is well-organized with descriptive section headers and navigable structure. However, at ~115 lines the dense --workers reference material is inlined where a separate reference file would fit, matching anchor 4 ('most content appropriately placed; minor organization gaps') rather than the well-split anchor 5. | 4 / 5 |
Total | 15 / 20 Passed |