Content
90%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.
An exceptionally dense, actionable reference that gives copy-paste Cypher, exact tool signatures, and the specific off-by-one and edge-table gotchas a maintainer needs. It loses a point only on workflow_clarity and progressive_disclosure because it is a single-file read-only reference rather than a multi-step workflow with external references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, expert-grade prose that assumes competence — references "Ferrante control dependence (post-dominators)", "GEN/KILL def→use", and WAL/meta-probe internals with no boilerplate explanation of what a graph or dependency is; every line is load-bearing. | 5 / 5 |
Actionability | Provides a copy-paste-ready Cypher query, concrete `pdg_query({ mode: 'controls', target })` / `{ mode: 'flows', target, variable? }` invocations, exact source file (`gitnexus/src/mcp/local/local-backend.ts`, `_pdgQueryImpl`), and precise off-by-one corrections (1-based block vs 0-based symbol lines, `+1` on both bounds). | 5 / 5 |
Workflow Clarity | Clear structure — build order (L1/L2/L5), the two modes, the corrected guard-clause Cypher, and a load-bearing gotchas list — but it is a read-only query reference rather than a multi-step destructive workflow, so explicit validation checkpoints do not apply; the no-layer "note, not an error" handling is the closest thing to a verification step. | 4 / 5 |
Progressive Disclosure | A single self-contained, well-sectioned SKILL.md (~85 lines) with clear headers and no external bundle files; content is appropriately kept inline for a focused reference, sitting just above the under-50-line simple-skill threshold so it does not quite reach a 5. | 4 / 5 |
Total | 18 / 20 Passed |