Content
96%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 tightly engineered instruction skill: lean to the point of terse, fully actionable with real git/gh commands, and a workflow whose validation gates and feedback loops are integral rather than bolted on. The single structural weakness is that two of the six referenced paths live outside the skill's own bundle and do not resolve in the provided file layout, slightly undercutting the otherwise model reference table.
Suggestions
Ship assets/writing.md and scripts/prose-lint.py as part of the skill's own bundle (e.g. under references/ or scripts/ within the skill directory), or document that they are host-plugin files, so every path in the Required references table resolves from the skill alone.
Add a one-line fallback for step 8–9 when ../../assets/writing.md or scripts/prose-lint.py is absent (e.g. proceed with the report-template rules in references/report.md and skip linting), so the workflow degrades gracefully outside the full plugin install.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational instruction with zero padding — e.g. "Trust nothing. The description, the diff, green tests, and your own candidates are claims. They become findings only after step 7." — and no explanations of concepts Claude already knows. Not 4: there is no over-explanation left to trim; every line directs a step, a rule, or a gate. | 5 / 5 |
Actionability | Concrete, executable commands throughout: "`gh pr view <N>`, `gh pr diff <N>`, and `gh pr checks <N>`", "`git show <merge-base>:<path>`", "`git worktree add --detach`", and a lint script to run on the output, each bound to a numbered step. Not 4: as an instruction-only skill the guidance is fully actionable — every step names what to read, run, or record, with no pseudocode or vague direction. | 5 / 5 |
Workflow Clarity | Nine clearly sequenced steps with explicit validation gates — step 3 ("Confirm the problem exists in the base snapshot"), step 4 approach gate, step 7 ("Give every Medium or higher candidate an independent verdict") — plus a recorded end-state comparison and a feedback loop: "If one does not, go back to the step that produces it." Not 4: checkpoints and recovery loops are explicit at every stage, not merely present. | 5 / 5 |
Progressive Disclosure | The overview is lean and the reference table ("Read at" / "Holds" columns) is exemplary signaling, with audit.md, verify.md, report.md, and rationalizations.md all present and matching their described content. Not 5: two referenced paths — "`../../assets/writing.md`" and "`<plugin root>/scripts/prose-lint.py`" — do not resolve within the provided bundle, so a reader following the table hits unresolvable files. Not 3: all in-bundle structure is appropriately split and clearly navigable. | 4 / 5 |
Total | 19 / 20 Passed |