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 lean, highly actionable instruction-only skill with excellent workflow sequencing — explicit baseline/verify loops, bail conditions, and escalation thresholds for a file-editing (fix) mode. The main weaknesses are the missing trigger guidance inherited from the description, no shown call syntax for the referenced audit tools, and no bundle files backing the referenced flows.
Suggestions
Include one concrete example call for each flow (e.g. how to invoke audit_live and what arguments it takes) so the guidance is copy-paste executable.
Trim the verbatim repetition of the frontmatter description in "When to Use" and the generic Limitations boilerplate to save context tokens.
If audit_live/audit_diff/explain_rule are meant to be bundle scripts, add them under scripts/ (or note they are built-in tools) so referenced paths resolve.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no explanations of what WCAG or CDP are — with every section carrying operational content. Minor trimmable redundancy remains: the "When to Use" section repeats the frontmatter description verbatim and the generic "Limitations" boilerplate could be tightened, so it fits the 4 ("efficient; minor instances that could be trimmed") rather than the 5 anchor. | 4 / 5 |
Actionability | Concrete guidance throughout: a flow preference order with named tools ("audit_live", "audit_html", "audit_diff({ audit_name: \"before\" })", "explain_rule({ id })"), a grep fallback chain ("data-testid, id, aria-label → visible text → tree position"), and a full report template. However, the actual call syntax for the audit tools is never shown and no bundle scripts back them — minor gaps matching the 4 anchor rather than fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | Both modes have clear sequences with explicit validation and feedback loops: fix mode runs a baseline audit, applies fixes, then verifies via "audit_diff" that "-fixed covers your targets and +new is empty", with bail conditions ("Verification fails ... name it and stop") and stop-and-ask checkpoints (>50 violations, >10 mechanical fixes, out-of-scope files). This matches the 5 anchor: explicit validation steps, error-recovery loops, and escalation checklists. | 5 / 5 |
Progressive Disclosure | The body is well-organized into clearly signaled sections (modes, flows, scope, approach, recipe, bail conditions, output) with no nested references. However, it references five distinct tools/prompts ("audit_live", "audit-live-page prompt", "audit_html", "audit_diff", "explain_rule") whose backing files do not exist in the bundle (no scripts/ or references/ directory), a minor organization gap that fits the 4 anchor rather than the fully well-split 5. | 4 / 5 |
Total | 17 / 20 Passed |