Content
67%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-organized, largely actionable reference with concrete code for the most common patterns and excellent failure/anti-pattern tables. Its main weaknesses are redundant catalog one-liners that restate common knowledge and per-pattern coverage that stops at four patterns despite the skill's stated scope.
Suggestions
Trim the 31-pattern catalog to the patterns that genuinely need guidance (those with no native equivalent or non-obvious rules), replacing entries like Breadcrumb, Landmarks, and Table with a one-line pointer to the APG site.
Add per-pattern essentials (required roles and keyboard model) for Menu, Tree View, and Listbox, or move all per-pattern detail into a references/ file and keep only the decision guidance in SKILL.md.
State an explicit ordered procedure for the reviewing use case (e.g., check native-first violations, then role/state completeness, then keyboard model, then the failures and anti-patterns tables).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The per-pattern essentials, ARIA states table, and failure/fix tables are high-signal, but sizable stretches restate what Claude already knows: one-liners like "Breadcrumb: Hierarchical-location indicator", "Table: Tabular data (use `<table>`)", "Landmarks: Navigation regions", and a ~30-line 'first rule' section on native-vs-custom preferences. This is more than minor over-explanation (not 4) but the bulk is dense reference material (not 2). | 3 / 5 |
Actionability | Copy-paste-ready HTML for Combobox, Tabs, Disclosure, and Tooltip, each paired with required-ARIA and keyboard-behavior tables, plus concrete failure-to-fix and anti-pattern tables. It is not 5 because only 4 of the 31 cataloged patterns receive essentials — menu, tree, listbox, and treegrid keyboard models are absent despite the skill promising keyboard interaction per pattern. | 4 / 5 |
Workflow Clarity | A clear implicit decision flow runs through the sections: prefer native HTML (first-rule table), match the APG pattern exactly when custom is required, then audit against the failures and anti-patterns tables. It is not 5 because no explicit procedure is stated for the advertised 'reviewing' use case (e.g., an ordered audit checklist), though as a reference skill it has no risky multi-step operation requiring validation checkpoints. | 4 / 5 |
Progressive Disclosure | The single file is well-sectioned (Overview, When to use, pattern catalog, per-pattern essentials, states reference, failures, References), and external references (APG site, WAI-ARIA 1.2, sibling skills) are clearly listed and one level deep. It is not 5 because at ~240 lines the full 31-pattern catalog is content that could be split into reference files, though navigation remains easy. | 4 / 5 |
Total | 15 / 20 Passed |