Content
81%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 operational skill file: the phase workflow, tool-call ladder, budgets, gates, and failure handling are concrete and executable, and reference files are well-signaled and genuinely one level deep. The main cost is repetition of the evidence-provenance/write-plan contract across four sections of the body, which inflates length without adding information.
Suggestions
State the write-plan/read-plan provenance contract once (e.g., a short Hard-rules pointer to scripts/evidence-provenance.mjs plus references/evidence-provenance.md) and let Phases 4/5 and Deepen reference it instead of restating digest, byte-contract, and path-validator details.
Move the Deepen-mode step detail (re-anchoring rules, --replace receipt handling) into a references/deepen.md file, keeping a compact step list in the body, to shorten the main file and sharpen progressive disclosure.
Trim redundant restatements of the same rule (e.g., 'a Deepen run is its own session' appears in both Phase 1 and Deepen mode) to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (no explanations of graphs, PDGs, or planning concepts) and is dense with real constraints, but the evidence-provenance/write-plan/read-plan contract is restated in Hard rules, Phase 4, Phase 5, and twice in Deepen mode even though references/evidence-provenance.md owns the detail — 'mostly efficient but could be tightened'. Not 4: the repetition across four sections is more than 'minor instances of over-explanation'; not 2: there is no padding or teaching of known concepts. | 3 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: exact tool signatures ('query {search_query, task_context}', 'impact {target, direction}'), exact commands ('node .gitnexus/run.cjs analyze --index-only', 'scripts/evidence-provenance.mjs write-plan'), a normalized output path format ('docs/plans/YYYY-MM-DD-gitnexus-plan-<slug>.md'), per-category budgets in a table, and per-knob defaults with meanings. Every step names the precise command or call to make. | 5 / 5 |
Workflow Clarity | Phases 0–5 plus Deepen and Fallback modes are clearly sequenced, with explicit validation checkpoints throughout: the freshness gate and analyzer provenance check before refresh, one-retry rules for ambiguous results, source verification mandatory before citation, 're-anchor before re-pinning', digest/path mismatch blocking publication, and safe-write failure blocking plan release. These are genuine validate→fix→retry feedback loops of the kind the rubric rewards for write operations. | 5 / 5 |
Progressive Disclosure | Structure is good: each reference file is real, one level deep, and its ownership is stated at the point of reference ('references/pdg-slice.md … owns the tool calls, inclusion criteria, depth bounds'), and the script's byte contract is delegated to references/evidence-provenance.md. Not 5: the ~330-line body inlines a fair amount of provenance-writer and Deepen-mode detail that duplicates what the reference files already own, so the split is not as clean as a pure overview-plus-references layout. | 4 / 5 |
Total | 17 / 20 Passed |