Content
88%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 dense, highly actionable skill body: exact tool calls with CLI fallbacks, a validated multi-step workflow with error-recovery loops, and honest treatment of UNKNOWN/partial results. The only real weakness is token density — some advanced caveat material would sit better in a reference file, and a few sentences could be simplified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body explains nothing Claude already knows; virtually all prose is tool-specific gotcha handling (repo binding, worktree detection, stale index, partial/truncated flags) that earns its tokens. It falls short of score 5 because a few passages — the riskSharedAxes/group-mode paragraph and the long "Bind the repository first" qualification sentences — are convoluted and could be tightened or trimmed. | 4 / 5 |
Actionability | Every step is copy-paste ready: exact MCP calls (`list_repos {}`, `impact({target: "validateUser", repo: "my-app", direction: "upstream"})`), exact CLI fallbacks (`node .gitnexus/run.cjs impact "X" --direction upstream --repo .`), a concrete fallback when run.cjs is missing (`npx gitnexus`), sample outputs, and a fully worked multi-repo example. Not below 5: no pseudocode or vague directions appear anywhere. | 5 / 5 |
Workflow Clarity | The workflow is a numbered 0–4 sequence with a checklist, explicit validation checkpoints (bind repo before anything, confirm the diffed checkout, re-run on partial/truncated, stop on UNKNOWN until resolved), and feedback loops for error recovery ("If 'Index is stale' → run `node .gitnexus/run.cjs analyze`"). Not below 5: validation and recovery are explicit rather than implicit. | 5 / 5 |
Progressive Disclosure | The skill is a single file with no bundle directories (no references/, scripts/, or assets/ exist) and clear, well-signaled sections (When to Use, Workflow, Checklist, Understanding Output, Risk Assessment, Tools, Example). It is not score 5 because at ~165 lines the deep edge-case material (worktree semantics, group-mode riskSharedAxes, unusedAxes) is dense inline content that a one-level-deep reference file would relieve; it is above score 3 because navigation is easy and nothing is buried. | 4 / 5 |
Total | 18 / 20 Passed |