Content
71%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, code-first reference with a clear topical progression and built-in assertion checkpoints, held back by duplication and a broken reference link. Nearly everything shown is executable, but the file carries too much inline detail for SKILL.md and cites a nonexistent reference file.
Suggestions
Fix or remove the broken reference: 'references/lighthouse-config.md' is listed under References but does not exist in the bundle — either create it or drop the entry.
Move detailed Lighthouse config blocks (mobile/desktop throttling and screen emulation) and the Timing API section into reference files, keeping SKILL.md as a lean quick-start overview.
De-duplicate Web Vitals coverage: keep one approach inline (the working library or PerformanceObserver version) and defer the other to the existing references/web-vitals-guide.md; replace the non-executable addInitScript import string with a bundled/CDN-compatible snippet.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is code-dense with almost no concept over-explanation — comments carry useful threshold values ('Good LCP < 2.5s'). However, there is notable repetition that could be trimmed: the near-identical mobile vs desktop audit blocks, two separate Web Vitals approaches (manual PerformanceObserver vs library), and Web Vitals measurement code that duplicates references/web-vitals-guide.md. This fits 'efficient; minor instances that could be trimmed' rather than the lean anchor 5. | 4 / 5 |
Actionability | Nearly all snippets are complete, executable TypeScript with imports, thresholds, and a full CI YAML workflow — copy-paste ready for the common cases. One notable gap: the 'web vitals with library' example injects an ES-module import ('import { onLCP ... } from \'web-vitals\'') via page.addInitScript, which will not execute in the browser context without a bundled/CDN build, so it is not truly copy-paste runnable. This keeps it at 'mostly executable; minor gaps' rather than anchor 5. | 4 / 5 |
Workflow Clarity | The content follows a logical progression (Installation → Quick Start → audits with thresholds → Web Vitals → budgets → throttling → reporting → CI), and test assertions ('expect(lcp).toBeLessThan(2500)', threshold-based failures) act as built-in pass/fail checkpoints. Minor gaps: no guidance on what to do when an audit fails or how to diagnose regressions, and the 'With Thresholds' example has only a comment where an assertion would go. 'Clear sequence with most checkpoints; minor validation gaps' fits best; the operations are non-destructive so the destructive-cap does not apply. | 4 / 5 |
Progressive Disclosure | Section organization is good, but the References section lists 'references/lighthouse-config.md', which does not exist in the bundle — a broken navigation pointer. Additionally, substantial detail that belongs in reference files is inlined (Lighthouse mobile/desktop config blocks, the two Web Vitals measurement approaches that duplicate the existing web-vitals-guide.md, the full Timing API section), leaving a ~500-line SKILL.md. This matches 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline'. | 3 / 5 |
Total | 15 / 20 Passed |