CtrlK
BlogDocsLog inGet started
Tessl Logo

html-size

Use when auditing page weight for crawl efficiency, investigating why certain page content is not appearing in Google's index, or reviewing server-rendered pages that embed large JSON payloads in HTML.

64

Quality

76%

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/html-size/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

A lean, highly actionable skill body with a concrete measurement command, explicit thresholds, cause-to-fix mapping, and a properly structured one-level reference to references/rule.md. The only notable issues are the triple repetition of the 15MB limit fact and the absence of a re-measurement verification step after fixes.

Suggestions

Consolidate the 15MB-limit explanation into one place (e.g. keep it in Quick Reference and trim its restatement in the intro and 'Explain' sections) to tighten token efficiency.

Add a final verification step to the Fix workflow, e.g. 'Re-run the curl measurement to confirm the page is under 2MB', and provide a command for counting the byte size of __NEXT_DATA__ script blocks since the Code Review section asks for it.

DimensionReasoningScore

Conciseness

The body is dense and domain-specific — explicit thresholds (2MB/5MB/500KB), enumerated causes, and concrete fixes — with no explanation of concepts Claude already knows. Not 5 because the ~15MB crawl limit and its consequences are stated three times (intro, Quick Reference, Explain), and the 'Explain' section largely repeats the intro paragraph.

4 / 5

Actionability

Provides a copy-paste curl command to measure raw HTML size, explicit flag thresholds, and five enumerated causes each paired with a specific fix (externalize SVGs, CDN images, gzip/Brotli, minify, reduce getServerSideProps data). Not 5 because the Code Review section instructs counting __NEXT_DATA__ block bytes without giving a command to do so.

4 / 5

Workflow Clarity

Clear Check → diagnose cause → matching Fix sequence with explicit decision checkpoints (2MB investigate, 5MB critical, 500KB per script block). Not 5 because there is no post-fix verification step (re-measure to confirm the page is under target); the non-destructive nature of the task means the validation cap does not apply.

4 / 5

Progressive Disclosure

A well-sectioned ~50-line overview with a single clearly signaled, one-level-deep pointer: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and that file exists in the bundle with no further nested references. Content is appropriately split and navigation is easy.

5 / 5

Total

17

/

20

Passed

Description

75%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.

A well-crafted trigger-focused description with three concrete, naturally-phrased use scenarios in a distinct SEO niche. Its main weakness is that the description is entirely 'Use when...' clauses — the skill's core capability (measure HTML document size, flag pages over crawl limits, and fix the causes) is only implied, never explicitly stated.

Suggestions

Lead with an explicit 'what' statement before the triggers, e.g. 'Measures HTML document size against Googlebot's ~15MB crawl limit, identifies causes of oversized HTML, and applies fixes. Use when...'

Add missing natural trigger synonyms such as 'crawl budget', 'HTML size', or 'pages not being indexed' to broaden keyword coverage toward anchor 5.

DimensionReasoningScore

Specificity

Lists three concrete, domain-specific actions ('auditing page weight for crawl efficiency', 'investigating why certain page content is not appearing in Google's index', 'reviewing server-rendered pages that embed large JSON payloads in HTML'). Not 5 because the core capability (measuring HTML size against crawl limits and fixing oversized pages) is only implied rather than stated.

4 / 5

Completeness

The 'when' is explicit and strong ('Use when auditing... investigating... or reviewing...'), but the 'what' is conveyed only implicitly through those verb phrases — the skill's actual check/fix workflow is never stated. Between anchor 3 (missing or implied half) and anchor 5 (both explicit); the implicit 'what' places it at 4.

4 / 5

Trigger Term Quality

Natural phrases users would say include 'page weight', 'crawl efficiency', 'not appearing in Google's index', and 'large JSON payloads in HTML'. Not 5 because common variations like 'HTML size', 'crawl budget', and 'indexing issues' are missing; not 3 since coverage of natural domain terms is solid.

4 / 5

Distinctiveness Conflict Risk

Clear niche (HTML page weight vs. Googlebot crawl/indexation limits) with distinct triggers like 'large JSON payloads in HTML' and 'not appearing in Google's index'. Minor overlap risk with generic page-performance or crawl-budget skills keeps it below 5.

4 / 5

Total

16

/

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.