Content
88%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.
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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |