Content
76%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 dense, calibrated checklist skill: concrete numeric criteria throughout, a clear severity taxonomy, and a copy-paste output template. Its weaknesses are the implicit (unnumbered) workflow and the two sections that delegate to 'ux-audit' content that is not bundled here.
Suggestions
Add a short numbered workflow near the top (e.g., 1. Resolve URL, 2. Open in detected browser tool, 3. Screenshot light AND dark mode, 4. Work through the 7 check categories, 5. Assign severities, 6. Write report to .jez/artifacts/design-review.md) so the sequence and the light/dark-mode checkpoint are explicit rather than implied by section order.
Inline the actual browser tool detection and URL resolution steps instead of 'Same as ux-audit — Chrome MCP, Playwright MCP, or playwright-cli', since that sibling skill's content is not part of this bundle and the deflection leaves an execution gap.
State an explicit verification checkpoint that every High finding has a corresponding screenshot attached before the report is written, turning the screenshot instruction into a validating step of the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a functional check with concrete thresholds ('Body text 50-75 characters per line', '150-200ms ease', '44x44px on mobile', 'WCAG AA (4.5:1 for body)'), not explanation of concepts Claude already knows. The tables, severity guide, output template, and tips all earn their tokens; there is no padding or tutorial-style prose, so no neighbor anchor fits better. | 5 / 5 |
Actionability | The check tables give measurable good/bad criteria, the severity guide is concrete, and the Output section provides a copy-paste-ready report template with an exact path ('.jez/artifacts/design-review.md'). It misses a 5 because 'Browser Tool Detection' and 'URL Resolution' defer entirely to another skill ('Same as ux-audit — Chrome MCP, Playwright MCP, or playwright-cli') without inlining the actual steps, leaving a gap if that skill's content is unavailable. | 4 / 5 |
Workflow Clarity | The operational flow (resolve URL → detect browser tool → run the 7 check categories → assign severity → write the report) is only implicit in section ordering; there is no explicit step sequence or checkpoint (e.g., 'screenshot both light and dark mode before writing findings' exists only as a tip). This matches 'sequence present but checkpoints missing or implicit'; the destructive/batch cap does not apply since this is a read-only review, and a 4 would require an explicit sequence. | 3 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the single SKILL.md is well-organized into clear sections with a consistent table format. The 7 check-category tables (~150 lines total) could arguably live in a reference file to slim the main file, which is the minor organization gap separating this from a 5; the under-50-lines simple-skill exception does not apply. | 4 / 5 |
Total | 16 / 20 Passed |