CtrlK
BlogDocsLog inGet started
Tessl Logo

speculation-rules

Use when optimising multi-page navigation performance, reducing INP on page transitions, or implementing progressive enhancement for fast page loads.

47

Quality

50%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/speculation-rules/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

36%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a pure trigger clause: it answers when to use the skill with several natural performance phrases, but never says what the skill does — the Speculation Rules API, prefetch, or prerender appear nowhere. Distinctiveness against other performance skills suffers for the same reason. Adding an explicit action statement naming the technique would fix both gaps.

Suggestions

Add a what-statement naming the technique, e.g. 'Implement the Speculation Rules API to prefetch and prerender likely next-page navigations. Use when...' — this lifts both completeness and specificity.

Include the skill's core vocabulary as trigger terms: 'prefetch', 'prerender', 'speculation rules', and 'instant navigation' — the phrases a user is most likely to actually say.

Mention scoped targeting (href-matches / document rules) to sharpen distinctiveness against generic page-speed or resource-hint skills.

DimensionReasoningScore

Specificity

The description names the domain ('multi-page navigation performance', 'INP on page transitions', 'progressive enhancement') but states no concrete actions or the actual technique — the Speculation Rules API, prefetch, and prerender are never mentioned, matching the 'names the domain but actions are minimal or generic' anchor. It is not a 1 because the domain terms are concrete rather than purely abstract, and not a 3 because no specific capability (e.g., 'prefetch and prerender navigations') is listed.

2 / 5

Completeness

Only the 'when' is present ('Use when optimising...', 'reducing...', 'or implementing...') with no statement of what the skill does, which is the anchor-2 case 'only when is present without what'. Not a 3 because that anchor requires a clear 'what', which is entirely absent — a reader cannot tell the skill implements the Speculation Rules API.

2 / 5

Trigger Term Quality

Relevant natural phrases are present ('navigation performance', 'page transitions', 'fast page loads'), but the most likely user phrasings — 'prefetch', 'prerender', 'speculation rules', 'instant navigation', 'MPA' — are all missing, matching 'some relevant keywords but missing common variations or synonyms'. Not a 4 because the omission includes the skill's own core vocabulary, not just a few synonyms.

3 / 5

Distinctiveness Conflict Risk

Trigger phrasing around general page-load performance overlaps with other web-performance skills (resource hints, lazy loading, image optimisation), and the distinguishing keyword 'speculation rules' is missing. It is somewhat specific (navigation/INP focus) but could still catch the wrong skill, matching anchor 3. Not a 4 because without the API name the boundary from sibling performance skills is unclear.

3 / 5

Total

10

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.