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.
The body is well-structured and highly actionable, with concrete commands, a clear sequenced workflow, and excellent progressive disclosure via a reference table. The only real gaps are a slightly redundant opening line and a missing validation checkpoint before posting the PR comment.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but the opening sentence 'Evaluates npm/yarn package version upgrades by performing source-level diff analysis, tracing all call sites, and producing a structured compatibility report.' nearly duplicates the frontmatter description and could be trimmed. | 4 / 5 |
Actionability | The Key Commands block provides fully executable, copy-paste-ready bash covering download/extract, file-list diff, source diff, direct and indirect usage search, and metadata checks, with the common cases specifically addressed. | 5 / 5 |
Workflow Clarity | A clear 10-step sequenced workflow with built-in verification ('Trace each call site to verify argument usage and compatibility', 'Assess compatibility risks'), but there is no explicit validation checkpoint before the outward-facing 'gh pr comment' post, leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | A Quick Reference table links to three real one-level-deep bundle files (review-workflow.md, report-template.md, example-report.md) with descriptions, giving a clear overview with well-signaled, easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |