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.
A tight, well-sequenced research workflow with concrete commands, exact file paths, and genuine validation checkpoints (confirm the problem, verify ownership, verify claims, report blockers). Its only weakness is step 2's file-location guidance, which stays high-level without a concrete search command or path-mapping example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout: no explanations of concepts Claude already knows, every section carries non-obvious project-specific guidance (vendored path rules, the '/manuals' prefix mapping, the specificity contrast example). The 'Notes' section is brief and each line changes behavior rather than padding. Matches the lean/every-token-earns-its-place anchor. | 5 / 5 |
Actionability | Concrete, executable guidance dominates: a complete 'gh issue view' command with flags, exact read-only paths ('_vendor/', 'data/cli/', 'content/reference/cli/'), a live-site URL template, and a good/bad specificity example. Not a 5 because step 2 ('Search content/ using the URL or topic') gives no concrete search command or example, and the '/manuals prefix mapping' is alluded to rather than shown. Well above the pseudocode midpoint. | 4 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit validation checkpoints at every risky point: confirm the candidate file 'contains the reported problem' (step 2), verify editable ownership before planning edits (step 3), 'Do not plan a fix based on an unverified claim' and 'report it as a blocker rather than guessing' (step 5). These verification and blocker-reporting feedback loops match the top anchor; this is a research (non-destructive) skill so the destructive-cap rule does not apply. | 5 / 5 |
Progressive Disclosure | A single well-organized ~70-line body with clean numbered sections and no monolithic inlining; the only external pointer ('See the vendored content table in CLAUDE.md') is one level deep and clearly signaled. No bundle files exist and none are needed — the structure satisfies the no-external-references case. Easy to navigate; matches the top anchor. | 5 / 5 |
Total | 19 / 20 Passed |