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 lean, well-sequenced instruction skill with concrete tool-call guidance and an explicit empty-outcomes guardrail. The only gap is the absence of a concrete before/after prompt example to ground the abstract reconciliation verbs.
Suggestions
Add a short before/after snippet showing one rule being promoted (or one false-positive being added to the 'do not flag' section) to make the reconcile step copy-paste concrete.
Show the expected shape of the analysis_summary string (e.g. a one-line template) so the 'names what changed this cycle' guidance is unambiguous.
Specify the light gh top-up step more concretely (e.g. a sample gh pr list invocation and how many PRs to sample) so 'Optionally do a light gh top-up' is executable rather than aspirational.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and targeted with no concept-padding Claude already knows; every line ('promote the recurring ones... quoting the file/diff_hunk context', 'Look for repetition, not one-offs') earns its place. | 5 / 5 |
Actionability | Concrete tool calls with named parameters and constraints ('Call save_review_style_prompt once with the refined custom_prompt (400–1200 words)', 'analysis_summary that names what changed') are actionable, but the prompt-editing guidance ('strengthen rules', 'remove or soften rules') stays abstract without a before/after example. | 4 / 5 |
Workflow Clarity | A clearly numbered 1-2-3 sequence (Read outcomes, Reconcile, Save) with an explicit validation/feedback loop: 'If outcomes were empty and nothing changed... re-save the existing prompt unchanged rather than degrading it.' | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references and three well-organized numbered sections, satisfying the simple-skill exception for progressive disclosure. | 5 / 5 |
Total | 19 / 20 Passed |