Content
86%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 tight, well-structured reference skill: token-efficient tables, concrete URIs/commands, a clear entry-point workflow with a staleness checkpoint, and clean self-contained organization. The main gaps are the absence of any MCP tool invocation example and limited recovery guidance when a repo is not indexed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean quick-reference: dense tables of project-specific facts Claude cannot know (MCP tool semantics, resource URIs, graph node/edge types) with no padding or explanations of general concepts. Every line carries information Claude does not already have. | 5 / 5 |
Actionability | Concrete, copy-paste-ready items are given: exact resource URIs ('gitnexus://repo/{name}/context'), an exact CLI command ('node .gitnexus/run.cjs analyze'), and a runnable Cypher query. Not 5: no example of actually invoking an MCP tool with its parameters, and the '{name}' placeholder resolution is only implicitly covered via list_repos. | 4 / 5 |
Workflow Clarity | 'Always Start Here' gives a numbered 3-step entry sequence plus an explicit staleness checkpoint with remediation ('If step 1 warns the index is stale, run node .gitnexus/run.cjs analyze first'). Not 5: only one checkpoint exists — there is no guidance for recovery when a repo is not indexed at all, and the follow-on skill workflows are delegated rather than validated. | 4 / 5 |
Progressive Disclosure | No bundle files (references/, scripts/, assets/) exist, and the ~60-line body is fully self-contained with well-organized sections: entry workflow, task-to-skill dispatch table, tools table, resources table, and schema summary. Per the rubric's simple-skill guidance, well-organized sections with no need for external references earn a 5. | 5 / 5 |
Total | 18 / 20 Passed |