Content
82%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 highly actionable, well-organized command reference with copy-paste commands and concrete flags throughout. It is slightly verbose in a few edge-case passages and lacks explicit validation for the destructive clean operation.
Suggestions
Tighten the long blockquote (npm 11.x crash workarounds) and the --watch rejected-flags list in the analyze section; move detailed version-specific fallbacks to a troubleshooting sub-section or external reference to improve conciseness.
Add an explicit validation step after 'clean' (e.g., run 'status' to confirm the index is gone) and state a numbered 're-run analyze if the context check fails' loop to strengthen workflow_clarity for the destructive/batch operations.
Consider splitting the npm/bun troubleshooting edge cases into a references file so SKILL.md stays a lean overview, lifting progressive_disclosure toward the one-level-deep-reference ideal.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no basic-concept padding, but the npm 11.x crash blockquote and the long --watch flag-rejection list are verbose edge-case passages that could be trimmed. | 4 / 5 |
Actionability | Every command has a copy-paste-ready bash snippet ('node .gitnexus/run.cjs analyze', 'status', 'clean', 'wiki', 'list') plus concrete flag tables covering the common cases. | 5 / 5 |
Workflow Clarity | The 'After Indexing' sequence (run analyze -> read context to verify loaded -> use other skills) has an explicit verify checkpoint and troubleshooting covers stale-index recovery, but there is no explicit post-clean verify step or numbered re-run loop. | 4 / 5 |
Progressive Disclosure | Clear section headers (Commands, After Indexing, Troubleshooting) with per-command subsections give easy navigation; no bundle files exist so there are no one-level-deep references, and the npm-11.x troubleshooting block could arguably live in its own file. | 4 / 5 |
Total | 17 / 20 Passed |