Content
75%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.
The content is a dense, well-sequenced audit workflow with runnable coverage and debt-scanning commands and a clear audit-only boundary. Weaknesses are mild: some duplication of stop-condition guidance, an ambiguous coverage-directory placeholder, no concrete scoring method for ranking files, unspecified artifact filenames, and implicit rather than explicit verification checkpoints.
Suggestions
Consolidate the stop-condition guidance (Goal, Core Rules, and Stop Conditions all restate it) into a single section to trim redundant tokens.
Give step 3 a concrete scoring method or rubric (e.g., a point scale per seam type) so file ranking is reproducible, and specify exact output file paths and names for step 4's artifacts.
Clarify the '.coverage-repo-YYYY-MM-DDx' placeholder (what the trailing 'x' means) and add an explicit checkpoint that lcov.info was produced before proceeding to scoring.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and telegraphic with zero concept re-teaching, but stop-condition guidance is stated three times ('stop fake work before it starts' in Goal, 'If the remaining misses are mostly low-ROI dust, say stop' in Core Rules, and the Stop Conditions section). It is not 5 because that duplicated stop guidance could be trimmed; not 3 because there is no real over-explanation or padding. | 4 / 5 |
Actionability | Steps 1 and 2 give copy-paste executable commands ('bun test --coverage --coverage-reporter=lcov ...', 'pnpm test:profile -- --top 25', concrete rg patterns), but gaps remain: the '.coverage-repo-YYYY-MM-DDx' directory template is ambiguous, step 3 gives scoring criteria with no scoring method or formula, and step 4's artifact filenames ('a markdown map', 'a package TSV') are unspecified. It is not 5 because of those missing executable specifics; not 3 because the commands that are present are genuinely runnable. | 4 / 5 |
Workflow Clarity | Five numbered steps are clearly sequenced with a capture list in step 1 and per-step expectations, and the audit-first scope is explicit. Verification is mostly implicit — there is no checkpoint confirming lcov.info was actually produced before scoring, and no verification of written artifacts — so it is not 5; it is not 3 because the sequence, inputs, and outputs per step are well defined. | 4 / 5 |
Progressive Disclosure | There are no bundle files (no references/, scripts/, or assets/), and this ~170-line single-file skill is cleanly sectioned with its external inputs clearly signaled via '@.agents/rules/...' paths. Content is appropriately self-contained; minor gap in that the scoring rules and roadmap template could be split into a reference file as the skill grows. It is not 5 because it exceeds the small-skill case where sectioning alone would suffice; not 3 because nothing is buried or inlined that clearly belongs elsewhere. | 4 / 5 |
Total | 16 / 20 Passed |