Content
50%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and dense, but it duplicates web-quality knowledge Claude already has, gives abstract rather than executable workflow steps, and fails to surface the bundled analyze.sh script. Tightening the inline checklists into referenced files and wiring the analyzer script into the workflow would lift the weaker dimensions.
Suggestions
Reference and invoke scripts/analyze.sh in the 'How it works' workflow (e.g. 'Run scripts/analyze.sh <target> for automated HTML checks') so the bundled tool is actually used and findings are verifiable.
Split the four audit categories (Performance, Accessibility, SEO, Best Practices) into one-level-deep reference files (e.g. references/performance.md) and keep SKILL.md as a concise overview with clearly signaled links, instead of inlining all ~150 checks.
Replace the abstract 'How it works' steps with a concrete sequence that includes a validation checkpoint (run analyzer -> review findings -> re-run after fixes), and trim the well-known threshold restatements to only the non-obvious values.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is prose-lean (bulleted checklists, no explanatory padding) but ~165 lines largely restate Lighthouse's own categories and well-known thresholds (LCP<2.5s, INP<200ms, CLS<0.1, WCAG 4.5:1, POUR) that Claude already knows, so not every token earns its place; this fits anchor 2 ("mostly efficient but could be tightened") better than the every-token-earns-its-place bar of 3. | 2 / 3 |
Actionability | It provides a concrete output template and severity table, but the "How it works" steps are abstract ("Analyze the provided code/project", "Provide specific actionable recommendations") with no executable commands or code, and critically it never references the bundled scripts/analyze.sh; this matches anchor 2 ("some concrete guidance but incomplete; missing key details") rather than the copy-paste-ready level of 3 or the purely-descriptive level of 1. | 2 / 3 |
Workflow Clarity | The four numbered "How it works" steps and audit-output template give a recognizable sequence, but there is no explicit validation/verification checkpoint and the bundled analyzer script is not wired into the flow, matching anchor 2 ("steps listed but validation gaps; checkpoints missing or implicit"); it is above 1 (steps are present) but below 3 (no explicit validate-and-retry feedback loop). | 2 / 3 |
Progressive Disclosure | There are no references/ or assets/ bundle files; the four audit categories are all kept inline in one ~165-line file (content that could be split into per-category reference files), and the only References section points to sibling SKILL.md files rather than bundle materials, fitting anchor 2 ("some structure but content that should be separate is inline"); it is not the monolithic/nested-2+-levels case of 1 nor the well-signaled one-level-deep split of 3. | 2 / 3 |
Total | 8 / 12 Passed |