Content
88%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, highly actionable review workflow: concrete git commands, an exact finding format, a MockServer trigger table, and a pre-verdict validation checklist. The main improvement opportunities are trimming the Lens Priority section's duplication of the external constitution and moving the detailed trigger/priority tables into a bundled reference file so the skill is self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is commands, tables, and templates with no concept tutorials — it assumes Claude's competence ("The code is wrong until proven right"). The Lens Priority section re-enumerates many constitution principle IDs (COR-02/06/07/08/10/11, SEC-*, INC-*, CPX-*) that the already-mandated full read of review-constitution.md covers, which is trimmable duplication; efficient overall but not perfectly lean. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste-ready commands ("git diff --cached", "git ls-files --others --exclude-standard"), an exact finding-format template with fields and severity values, a mandated output structure, and a pattern-to-required-checks table for MockServer triggers. Not 4: there are no missing key details for executing the workflow. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced steps with an explicit validation gate — Step 7's "Before returning your verdict, verify ALL of these" checklist with per-item pass/fail, and a Step 8 rule banning hedged verdicts ("Do NOT use 'PASS with reservations'"). Sequence, explicit validation, and a checklist match the 5 anchor; the skill is read-only so no destructive-operation cap applies. | 5 / 5 |
Progressive Disclosure | Good structure: the heavy 8-lens framework is correctly externalized and clearly signaled ("Read .opencode/rules/review-constitution.md in full"), one level deep, and the remaining sections are scannable. Not 5: the skill ships no bundle files, and the two dense inline tables (Lens Priority, MockServer triggers) plus reliance on a non-bundled repo path leave minor organization gaps; not 3 because references are clearly signaled, not buried. | 4 / 5 |
Total | 18 / 20 Passed |