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 compact, high-signal body: executable setup code, concrete option defaults, and product-specific facts with zero filler. The only gap is slightly incomplete executable coverage around the optional peer dependency install and tool/output examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | 45 lean lines with no padding and no explanation of concepts Claude already knows — statements like "Hindsight owns extraction and ranking server-side" and "bank id is {tenantId|_}__{user}__{threadId}" are product-specific facts, not filler. Every section earns its place, matching the 'lean and efficient; assumes Claude's competence' anchor. | 5 / 5 |
Actionability | The Setup block is executable and copy-paste ready (imports, session-derived factory, middleware wiring) and Options list concrete values with defaults ("'low' | 'mid' | 'high'", "HINDSIGHT_URL or http://localhost:8888"). Minor gaps keep it at anchor 4 rather than 5: no install command for the optional peer dependency and no example showing budget/callback usage or what the returned tools look like. | 4 / 5 |
Workflow Clarity | A simple single-purpose skill — wire the adapter — where the single action is unambiguous, including a safety checkpoint ("never from req.body") for deriving the scope. No destructive or batch operations require validation, so the simple-skill exception applies and the score reaches 5. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (none exist in the bundle), and is cleanly organized into Setup, Options, and Tools sections — per the rubric guideline this earns a 5 with well-organized sections alone. | 5 / 5 |
Total | 19 / 20 Passed |