Content
81%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 audit workflow with strong sequencing and validation. Its main weakness is moderate redundancy in the screenshot-acceptance rules and a dense main body that could push more Figma/browser detail into references.
Suggestions
Consolidate the screenshot accept/reject guidance into one place; it is currently repeated across capture rules, screenshot source rules, and steps 5, 6, and 11.
Move the detailed Figma placement specs (200px/15-per-row/600px) and browser capture order into a reference file so the SKILL.md body stays a lean overview.
Tighten the Evidence rules and Capture rules sections, which overlap on 'use only current-run evidence' and 'do not audit until product/flow/tool are known'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but the screenshot accept/reject rule is restated across capture rules, screenshot source rules, and steps 5/6/11, which could be consolidated. | 3 / 5 |
Actionability | Highly concrete guidance — numbered file names like '01-start.png', explicit Figma layout values (200px spacing, new row every 15 screenshots, 600px row separation), and named checks (spinners, login walls, cookie dialogs); absence of code is acceptable for an instruction-only skill. | 5 / 5 |
Workflow Clarity | Clear 13-step per-step sequence with explicit validation checkpoints (wait for stability, inspect before accepting, reject if blank/loading) and feedback loops (reject and recapture), plus acceptance-checks and blockers checklists. | 5 / 5 |
Progressive Disclosure | The 'what to inspect' detail is appropriately offloaded to a real one-level reference (references/design-audit-framework.md) with clear section headers, though the body is fairly long with inlined Figma/browser detail that could be split out. | 4 / 5 |
Total | 17 / 20 Passed |