Content
78%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 well-structured, action-oriented skill body that defers detail to a single real reference file and avoids concept padding. The main opportunities are trimming mild repetition, adding a concrete invocation example, and making validation checks explicit rather than implied.
Suggestions
Consolidate the 'search before reading' guidance so it is stated once rather than repeated across steps 1 and 3, and prune goal→tool table rows that restate the workflow text.
Add at least one concrete codebase_search invocation snippet (with example arguments) so the guidance is copy-paste ready, lifting actionability toward a 5.
Make validation explicit in the workflow (e.g., 'Run codebase_graph_status before relying on graph results; if not ready, wait or trigger a build') rather than leaving it as an implicit checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and tactical with no over-explanation of concepts Claude already knows, but the 'search before reading' principle is restated across steps 1 and 3 and the goal→tool table partly duplicates the workflow prose, keeping it just below a 5. | 4 / 5 |
Actionability | Concrete tool names, parameters (fileFilter, languageFilter, minScore default 0.10, mode interactive), and an explicit grep-vs-search decision rule give mostly executable guidance, though the absence of literal invocation examples/snippets keeps it from a 5. | 4 / 5 |
Workflow Clarity | A clear 6-step numbered sequence with a status-check fallback and an indexing-recovery hint; validation is implicit (graph_status/codebase_status checks) rather than explicit gating, which is the minor gap versus a 5. | 4 / 5 |
Progressive Disclosure | A well-organized ~70-line overview with a single clearly-signaled one-level-deep reference to references/tool-reference.md (verified to exist) for full parameter details — a textbook clean split for a skill of this size. | 5 / 5 |
Total | 17 / 20 Passed |