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 instruction-only skill: a clear sequenced workflow with explicit QA, concrete ID/tracker conventions, and excellent progressive disclosure via a well-signaled reference table. Its main weaknesses are mild duplication between the stance and red-lines sections and the absence of a worked response example or an explicit QA feedback loop.
Suggestions
Merge the overlapping invention-prohibition lists in 'Default stance' and 'Red lines' into a single section to remove duplicated content and tighten the body (conciseness).
Add one short worked example of a single comment-response pair (preserved reviewer comment + evidence-linked reply + tracker row) to make the expected output concrete (actionability).
State a QA feedback loop explicitly, e.g. 'If QA fails, fix the flagged items and re-run the checklist before returning the package' (workflow_clarity).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence (no explanation of what peer review is), but "Default stance" and "Red lines" duplicate the same prohibitions ("Do not invent experiments... line numbers, figure panels" vs "Do not invent line numbers, figure panels, citations"), which is trimmable. Fits anchor 4 (efficient, minor over-explanation) rather than 5. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: task-mode names ("draft, audit, revise, triage-only, appeal-like"), ID schemes ("E.1", "R1.1", "R1.2"), readiness states, and a full output-format template with a tracker table. Falls short of anchor 5 only because there is no worked example of a single comment-response pair. | 4 / 5 |
Workflow Clarity | The 10-step workflow is clearly sequenced with explicit checkpoints (step 8 "Flag missing author input rather than fabricating details", step 9 QA for "completeness, traceability, factuality, tone, and unresolved risk", plus the qa-checklist reference). Below anchor 5 because no validate-then-fix-and-retry feedback loop is stated for audit-mode failures. | 4 / 5 |
Progressive Disclosure | The body is a concise overview and the "Related files" table points to nine one-level-deep references (all verified to exist), each with a clear "Open when" signal, matching the anchor-5 example of well-signaled one-level-deep references. | 5 / 5 |
Total | 17 / 20 Passed |