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.
The body is an exemplary lean routing guide: concrete call signatures with exact parameters, a sequenced flow with decision branches, explicit trust-signal checkpoints, and terse error-recovery paths. It assumes Claude's competence throughout and contains no padding or over-explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with Repowise-specific facts ('Skip it once you have the map', 'Cheaper than Read + offset math', 'a row without one is path::name') and explains nothing Claude already knows. The 'Recommended flow' adds confidence-branching and batching strategy rather than restating the table, so every token earns its place. | 5 / 5 |
Actionability | Guidance is copy-paste ready with exact parameter names and values — 'get_context(targets=["<symbol>"], include=["references"])', 'get_change_risk(revspec="<base>..HEAD")', 'get_symbol("path/to/file.py::Name")' — plus exact error strings and fallback slash commands. For an instruction-only skill this fully satisfies the executable-guidance anchor. | 5 / 5 |
Workflow Clarity | A clear 4-step recommended flow with explicit decision branches (high confidence → answer and cite; medium/low → follow best_guesses into get_context, then get_symbol), an explicit validation section ('Trust signals — verify when… Otherwise the response is current — act on it'), and error-recovery feedback loops (empty results → fall back to get_context; MCP unavailable → CLI slash commands). The skill is read-only, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed at this size; the body is well organized into four clearly signaled sections (tool routing table, recommended flow, trust signals, error handling) with no nested or buried references and no broken file links, making it easy to navigate as a single-level document. | 5 / 5 |
Total | 20 / 20 Passed |