Content
63%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.
The skill body is a well-structured, lean overview with exemplary progressive disclosure — the single one-level reference is clearly signaled and carries the implementation detail. Its weakness is actionability: the body itself contains no code or syntax, so a reader must hop to the reference before doing anything. The intro paragraph also duplicates text found verbatim in the reference file.
Suggestions
Include a minimal working <script type="speculationrules"> example inline in the Fix section so the core syntax is available without opening the reference.
Add a verification step to the workflow, e.g. checking the prerender status of a link in Chrome DevTools (Issues panel) to confirm the rules took effect.
Replace the duplicated 'Navigation latency is one of the biggest contributors...' paragraph with a one-line rationale, since the same paragraph appears verbatim in references/rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — the Check/Fix/Explain/Code Review sections are single tight sentences. Minor trim: the opening 'Navigation latency is one of the biggest contributors...' paragraph (including the Google Search anecdote) is duplicated verbatim in references/rule.md, so it is not quite the every-token-earns-its-place of anchor 5. Not a 3 because there is no real padding or explanation of known concepts. | 4 / 5 |
Actionability | The Fix section offers only high-level direction ('Add a Speculation Rules JSON block targeting the most likely next-page links, starting with prefetch and graduating to prerender') with no code, no example rule, and no syntax — the executable JSON lives only in references/rule.md, matching 'minimal concrete guidance; high-level hints but missing the specific steps'. Not a 3 because there is no pseudocode or partial snippet either; the body gives no concrete artifact to act on. Not a 1 because the Quick Reference does specify concrete mechanisms (href-matches, document rules, CSS selectors). | 2 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review structure gives a clear, coherent review sequence, and the progression 'starting with prefetch and graduating to prerender' orders the implementation sensibly. Not a 5 because there is no verification step (e.g., confirming rules took effect via Chrome DevTools' speculation status); not a 3 because no destructive/batch validation cap applies and the sequence has no gaps. | 4 / 5 |
Progressive Disclosure | The body is a concise overview and all implementation detail is split into references/rule.md — a real file, referenced exactly once, clearly signaled ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), one level deep. This matches the anchor-5 pattern of a clear overview with a well-signaled single reference. Not a 4 because there are no organization gaps: nothing that belongs in the reference is inlined in the body. | 5 / 5 |
Total | 15 / 20 Passed |