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 lean, well-structured instruction-only skill: system-specific conventions, concrete tool signatures, a clear drill-down workflow with stopping criteria and fallback guidance. The only gap is the absence of a fully literal worked-example call, leaving actionability just short of copy-paste ready.
Suggestions
Add one fully literal worked example, e.g. grep("viking://resources/specs", pattern=["rate limit"]), so the tool signatures become copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries system-specific knowledge Claude cannot infer (".abstract.md" / ".overview.md" summary levels, "Low scores (under ~0.4) are usually noise", when to use "search instead of find"). No filler and no explanation of concepts Claude already knows; every token earns its place. | 5 / 5 |
Actionability | Near-executable tool calls are given throughout: "find(query, target_uri=\"viking://resources\")", "grep(uri, pattern=[...])", "glob(pattern, uri) e.g. **/*.pdf", plus "read with offset/limit around the match". Not 5 because invocations use placeholder parameters with no single fully literal worked example (e.g., a real grep call with an actual pattern and URI) to copy-paste. | 4 / 5 |
Workflow Clarity | The drill-down is a clear numbered sequence (find hit → read .overview.md → list/scoped find/grep → read the file) with an explicit stopping criterion ("Stop as soon as you have what the task needs") and an error-recovery feedback loop ("If find returns nothing useful, list viking://resources... then search inside the closest directory"). Operations are read-only, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is ~45 lines with well-organized sections (Pick the tool / Drill down / Tips) and no external references needed; no bundle files exist, so this fits the under-50-lines exception for a top score. | 5 / 5 |
Total | 19 / 20 Passed |