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 code-rich, largely executable skill document with well-organized sections and assertion-based checkpoints, but it functions as a monolithic reference rather than an overview: nearly 500 lines inlined, one dangling reference (references/lighthouse-config.md does not exist), and a few code examples with small assembly gaps (unresolved 'web-vitals' import in addInitScript, missing `fs` import, missing package in install command).
Suggestions
Fix the broken reference: either create references/lighthouse-config.md or remove it from the References section, since the body currently points to a file that does not exist in the bundle.
Split bulk detail out of SKILL.md into one-level-deep reference files (e.g., move the mobile/desktop Lighthouse configs, Performance Timing API, budget definitions, and CI GitHub Actions YAML into references/), keeping SKILL.md to quick start, installation, and pointers.
Tighten code assembly gaps: import `fs` in the metrics-tracking example, use a CDN/bundled build for the web-vitals library in addInitScript (or document the setup), and add `web-vitals` to the npm install command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is code-dominant with almost no concept explanation (no 'what is Lighthouse' padding), and comments in code carry threshold knowledge compactly ("// Good LCP < 2.5s"), matching the 'efficient; minor instances of over-explanation that could be trimmed' anchor. It is not a 5 because the Quick Start largely duplicates the 'Basic Audit' example, several samples can only be assembled by combining snippets across sections (e.g., `fs` is imported in one example but used in a later one), and the ~490-line bulk exceeds what a SKILL.md overview needs. It is well above a 3 since there is no real concept teaching, just minor tightening opportunities. | 4 / 5 |
Actionability | Nearly all guidance is complete, executable TypeScript/YAML (playAudit calls with thresholds, PerformanceObserver snippets, CDP throttling commands, a GitHub Actions workflow), matching the 'mostly executable guidance; concrete code with minor gaps' anchor. It is not a 5 because of small execution gaps: the 'web vitals with library' example injects an ES-module `import ... from 'web-vitals'` via addInitScript content that won't resolve in the page without bundling/CDN setup, `fs` is used in the metrics-tracking example without a local import, and the web-vitals npm package is never added to the installation command. It clearly exceeds a 3 because the examples are real code, not pseudocode, and cover the common cases. | 4 / 5 |
Workflow Clarity | Each section is a self-contained, sequenced pattern (navigate -> measure -> assert), and the expect() assertions act as explicit checkpoints, matching the 'clear sequence with most checkpoints present; minor validation gaps' anchor. It is not a 5 because there is no guidance for flakiness handling in a domain where run-to-run variance is the core hazard (the Best Practices bullet 'Cache and repeat - Run multiple times for consistency' is a one-line hint with no concrete retry/median procedure), and there is no decision guidance for when to use Lighthouse vs raw PerformanceObserver. It is above a 3 because assertions/checkpoints are consistently present, not implicit. | 4 / 5 |
Progressive Disclosure | Per the bundle-aware guideline, scoring against the actual bundle: the body cites two reference files but only `references/web-vitals-guide.md` exists; `references/lighthouse-config.md` is a dangling reference. Additionally, ~490 lines of detailed presets (mobile/desktop Lighthouse configs, Navigation/Resource Timing, budget tables, CI YAML) are inlined in SKILL.md when they clearly belong in reference files, matching the 'some structure but could be better organized; content that should be separate is inline' anchor. It is not a 4 because of the broken reference and the monolithic bulk; it is above a 2 because sections are well-organized and the reference list at the end is clearly signaled rather than buried. | 3 / 5 |
Total | 15 / 20 Passed |