Content
78%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 highly actionable, well-organized reference with copy-paste HTML, precise ARIA tables, and cited edge-case rules (toggle labels, live regions, menu vs disclosure). Its main weaknesses are inline density — per-pattern detail that belongs in reference files — and minor duplication/over-explanation in the pattern catalog and failure tables.
Suggestions
Move the 'Per-pattern essentials' deep dives (combobox, tabs, tooltip, disclosure nav, toggle buttons, live regions) into one-level-deep files under references/ (e.g. references/combobox.md) and keep SKILL.md as an overview with the pattern catalog and a short pointer per pattern.
Merge the overlapping 'Common ARIA failures' and 'Anti-patterns' tables into a single table to remove duplicated entries (toggle label changes, aria-label on visible-text elements).
Drop or compress the 'When to use' column for well-known widgets (Button, Link, Table) and keep only the load-bearing 'Native fallback' column, and add a brief per-pattern test sequence like the disclosure-navigation one to the other pattern sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Almost entirely dense tables and complete code with no prose padding, but the 31-pattern catalog explains well-known concepts ('Button — Trigger an action', 'Link — Navigation to a different resource') and the 'Common ARIA failures' and 'Anti-patterns' tables partially duplicate each other (toggle labels, aria-label misuse). | 4 / 5 |
Actionability | Copy-paste-ready, complete HTML for combobox, tabs, disclosure, tooltip, and navigation patterns, concrete per-attribute 'why' tables, and executable verification guidance such as the Playwright assertion and the keyboard test sequence ('press Enter on the button, expect aria-expanded="true"'). | 5 / 5 |
Workflow Clarity | Decision guidance is unambiguous (native-preferred table, 'follow the matching APG pattern exactly', disclosure-not-menu for site nav), but there is no explicit end-to-end authoring/test sequence and step-by-step test procedures appear for only one pattern (disclosure navigation). | 4 / 5 |
Progressive Disclosure | Sections are clearly organized, but the ~335-line body inlines ~150 lines of per-pattern deep dives ('Per-pattern essentials') and full pattern catalog tables that belong in one-level-deep reference files; no bundle files exist, so SKILL.md carries all detail itself. | 3 / 5 |
Total | 16 / 20 Passed |