Content
92%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 exemplary instruction-only skill body: fully concrete tool calls and resource URIs, a numbered workflow with an explicit staleness checkpoint and recovery command, a checklist, and a worked example — all at under 3KB. The only improvement opportunity is consolidating the triple-rendered workflow (Workflow, Checklist, Example) and dropping the 'When to Use' section that duplicates the frontmatter triggers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no space is spent explaining what a codebase or execution flow is, and the Resources table even budgets token costs per resource. It falls short of anchor 5 because the same workflow is rendered three times (Workflow, Checklist, and the worked Example) and 'When to Use' repeats the frontmatter triggers — minor redundancy that could be trimmed. | 4 / 5 |
Actionability | Everything is executable: exact MCP resource URIs ('READ gitnexus://repos', 'READ gitnexus://repo/{name}/process/{name}'), concrete tool calls ('query({query: "payment processing"})', 'context({name: "validateUser"})'), a runnable recovery command ('node .gitnexus/run.cjs analyze'), and a fully worked end-to-end example covering a common case. This matches anchor 5's copy-paste-ready guidance with specific examples for the common cases. | 5 / 5 |
Workflow Clarity | The workflow is a clearly numbered 5-step sequence with an explicit checkpoint and recovery loop ('If step 2 says "Index is stale" → run node .gitnexus/run.cjs analyze'), a checklist for complex processes, and a grounding step ('Read source files for implementation details'). All operations are read-only, so the destructive/batch validation cap does not apply; this matches anchor 5's explicit validation steps, feedback loop, and checklist. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories), and none are needed — the ~75-line body is appropriately self-contained with well-organized sections (When to Use, Workflow, Checklist, Resources, Tools, Example). The resource table with per-resource token costs effectively implements lazy loading, matching the well-organized-simple-skill pattern the rubric rewards with a 5. | 5 / 5 |
Total | 19 / 20 Passed |