Content
78%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 well-structured, highly actionable instruction skill with a concrete method, labeling discipline, and output contract. Its weaknesses are repetitive restatement of the read-only/no-overclaim constraint and a single shared-invariants reference that escapes the skill bundle and cannot be verified, which weakens self-contained navigation.
Suggestions
Make the shared-invariants reference self-contained: either inline the relevant rules from templates/AGENTS.md into SKILL.md or ship that file inside the skill bundle (e.g. references/AGENTS.md) so the ../../templates/ path resolves for skill consumers.
Consolidate the read-only/no-overclaim constraint, which is stated four times across the intro, 'Use when', 'Evidence discipline', and 'Stop conditions', into one authoritative statement to trim tokens.
Add a one-row filled example of the 'Ranked synthesis' table (with a real confidence value and basis) so the output contract is unambiguous without interpretation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanation of concepts Claude already knows, but the read-only/no-overclaim constraint is repeated four times (intro line, "Do not use it for edits...", "never overclaim certainty" in Evidence discipline, and the Stop conditions section). That places it at the score-4 anchor (efficient with minor instances that could be trimmed) rather than 5's every-token-earns-its-place. | 4 / 5 |
Actionability | As an instruction-only skill it gives fully executable guidance: a 5-step method, an explicit Evidence/Inference/Unknown labeling taxonomy, and a copy-paste-ready output contract with exact section names, table columns (Rank/Explanation/Confidence/Basis), confidence levels, and `path/to/file:line-line` reference format. Per the rubric's code_vs_instruction note this matches the score-5 anchor; score 4 would require missing key details, and none are missing. | 5 / 5 |
Workflow Clarity | "Inputs and method" lists a clear 5-step sequence with an explicit stop condition and an escalation path ("name the smallest read-only probe that would resolve the remaining uncertainty"), plus a separate Stop conditions section. It sits at the score-4 anchor (clear sequence, most checkpoints present, minor gaps) rather than 5 because there is no explicit verify-then-proceed feedback loop on the synthesis itself (e.g., re-checking that every ranked claim has cited evidence before emitting output). | 4 / 5 |
Progressive Disclosure | Sections are well organized and the body is appropriately compact, but the skill's single reference — "[`templates/AGENTS.md`](../../templates/AGENTS.md)" for all shared invariants — points outside the skill bundle and does not resolve to a real file in the reviewed structure, so a consumer cannot navigate to the referenced content and the skill is not self-contained. This lands between the score-3 anchor (structure present but references problematic) and score-4 (references mostly clear); the unverifiable, bundle-escaping path keeps it at 3. | 3 / 5 |
Total | 16 / 20 Passed |