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 highly actionable, well-structured routing skill: concrete tool signatures with parameters, an explicitly validated workflow with confidence branches and recovery paths, and lean organization with no filler. The only flaw is mild repetition of the Grep/Glob/Read guidance across the intro, table, and flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (uses "MCP", "bm25", "embedding", "symbol_id" without explanation), but the Grep/Glob/Read guidance is repeated three times — in the intro ("For an exact identifier, string or file name, Grep, Glob and Read are faster"), the table's first row ("An exact identifier, string or file name | Grep, Glob and Read"), and flow step 3 — so minor trimming is possible, matching anchor 4 rather than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Every row gives an executable call with parameters — `get_context(targets=["<symbol>"], include=["references"])`, `get_symbol("path/to/file.py::Name")`, `get_change_risk(revspec="<base>..HEAD")` — plus verbatim error strings ("No repositories found. Run 'repowise init' first.") and exact slash-command fallbacks (`/repowise:ask`, `/repowise:context`), which is copy-paste-ready guidance covering the common cases per anchor 5. | 5 / 5 |
Workflow Clarity | The numbered "Recommended flow" sequences steps with confidence-based branching ("High confidence → answer it, cite the paths"; "medium/low confidence → follow best_guesses[0].file... into get_context"), the "Trust signals — verify when" section supplies explicit validation checkpoints (_meta.stale_warning, medium/low confidence, bm25), and "Error handling" gives feedback loops ("come back empty → ... Fall back to get_context with explicit paths") — clear sequence, validation, and recovery per anchor 5. | 5 / 5 |
Progressive Disclosure | The skill is a single self-contained file with no bundle directories (references/, scripts/, assets/ absent) and no external references, and all ~60 lines are decision-critical routing guidance organized into a tool table, recommended flow, trust signals, and error handling — nothing that belongs in a separate file is inlined, and navigation is easy, satisfying anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |