Content
100%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 exemplary operational skill body: every section carries precise call signatures, flag values, CLI equivalents, and interpretation guidance, with explicit validation checkpoints and error-recovery loops packed into a compact, well-sectioned single file. Nothing here is padding, and nothing needed is missing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: "Repowise scores **every file 1–10** from deterministic markers — McCabe complexity, deep nesting, brain methods, class cohesion (LCOM4), god classes, clone detection..." names markers without explaining them, and even the interpretive line about weights being "calibrated against a real defect corpus" is decision-relevant rather than padded. No section explains concepts Claude already knows, so it sits at anchor 5 rather than anchor 4 ('minor instances of over-explanation'). | 5 / 5 |
Actionability | Guidance is fully executable with exact call signatures and commands: `get_health(targets=["src/x.py", "src/y.py"])`, literal include-flag values ("biomarkers", "refactoring", "coverage", "trend"), `repowise coverage add cov.lcov` with accepted formats, and `repowise health --recompute`. This matches anchor 5 ('copy-paste ready; specific examples cover the common cases'); anchor 4 would require minor gaps in executable detail, and none are present for the documented surface. | 5 / 5 |
Workflow Clarity | Mode selection is driven by input (dashboard vs. targeted), and the results workflow includes an explicit validation checkpoint — "Check `unresolved` before calling a file clean" — plus feedback loops: "`not_indexed` means run `repowise update`" and no-repository → suggest `/prompts:repowise-init`. The task is read-only analysis, so the destructive/batch cap does not apply; explicit validation and error recovery place it at anchor 5 rather than anchor 4. | 5 / 5 |
Progressive Disclosure | This is a single-file skill (~46 content lines, no references/, scripts/, or assets/ directories exist) whose small API surface needs no external files; the section structure — "Pick the mode by what you pass", "Useful `include` flags", "How to use the results", "CLI equivalents", "Error handling" — is well-organized and easy to navigate. Per the rubric's simple-skill note, this earns anchor 5 with well-organized sections and no buried or nested references. | 5 / 5 |
Total | 20 / 20 Passed |