Content
67%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 content is a well-sequenced, highly actionable procedure with real validation and fallback handling; its main weaknesses are minor verbosity in path handling and the lack of any external reference split despite exceeding 50 lines.
Suggestions
Factor the duplicated eight-path candidate list into a shell array so the search loop and the error echo share one source of truth, trimming ~15 lines.
Consider extracting the long path-resolution block (step 3) into a bundled script under scripts/ to shorten SKILL.md and improve progressive disclosure.
Add a one-line 'Prerequisites' note up front (knowledge graph must exist from /understand) so the validation in step 2 is anticipated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly executable bash with little concept-explanation fluff, but the eight-path candidate enumeration is duplicated in the error echo and the fast-path/fallback split adds length that could be tightened, matching 'mostly efficient but could be tightened'. | 3 / 5 |
Actionability | Each step ships copy-paste-ready bash with explicit `${VAR:?...}` guards and concrete fallback commands, but snippets rely on shell state carried between steps and a couple of details (npx viewer download, build filter) are context-dependent, fitting 'mostly executable, minor gaps'. | 4 / 5 |
Workflow Clarity | Steps 1-8 are clearly numbered with explicit validation checkpoints (knowledge-graph.json existence, plugin-root resolution) and a fast-path->fallback recovery branch; it lacks a true fix-and-revalidate loop, so it sits just below the 5 anchor. | 4 / 5 |
Progressive Disclosure | The skill is self-contained with clear ## Instructions and ## Notes sections and numbered steps, and none of the bash clearly belongs in a separate file; it is well-structured for a linear procedure, though at ~155 lines with no references it does not reach the one-level-deep reference ideal of a 5. | 4 / 5 |
Total | 15 / 20 Passed |