CtrlK
BlogDocsLog inGet started
Tessl Logo

defer-async

Use when reviewing templates, rendered HTML, or shared components related to Load scripts with defer, async, or type=module. Validate the final browser-facing markup, not just the source framework abstraction.

61

Quality

72%

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/defer-async/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 well-structured, appropriately disclosed review skill with a clear Check/Fix workflow and a verified one-level reference. Its weakest point is token efficiency: the intro and Quick Reference re-explain defer/async basics Claude already knows, and a short good/bad markup example would make the guidance fully self-contained.

Suggestions

Cut or compress the opening paragraph and Quick Reference to only what is not common knowledge (e.g. keep only the 'Never place scripts in <head> without defer or async' rule and the defer-vs-async decision line), moving the explanatory timing content to references/rule.md where it already lives.

Add a minimal before/after markup pair (blocking <script src=...> in <head> vs. <script defer src=...>) to the Check or Fix section so the review criterion is unambiguous.

Tighten the Fix section with the defer-vs-async choice rule so it doesn't depend on the Quick Reference for the decision.

DimensionReasoningScore

Conciseness

The opening paragraph re-explains what a parser-blocking <script> tag does and the Quick Reference re-teaches the defer/async/type=module semantics — concepts Claude already knows. The Check/Fix/Explain/Code Review sections themselves are tight, so this sits at 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 'noticeably verbose'.

3 / 5

Actionability

The Check and Fix sections give concrete, executable review instructions ("Flag any in the <head> without defer or async, and any at the bottom of <body> that could be in <head> with defer"; "Add defer or async to script tags in the document head, or convert to type=module"). Minor gaps keep it below fully copy-paste-ready: no before/after markup example of a violating vs. fixed script tag inline.

4 / 5

Workflow Clarity

A clear Check → Fix → Explain → Code Review sequence for a single-purpose review task; the check criteria are specific enough that no validation checkpoints are needed for this non-destructive workflow. It falls just short of 5 because the criterion "any at the bottom of <body> that could be in <head> with defer" leaves a judgment call undefined, and the Fix does not restate when to choose defer vs. async.

4 / 5

Progressive Disclosure

The body is a well-organized ~35-line overview with clear sections and a single, clearly signaled, one-level-deep pointer ("see `references/rule.md`" — verified to exist, 139 lines, not nested further). Content is appropriately split between the overview and the reference file.

5 / 5

Total

16

/

20

Passed

Description

73%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 solid description with an explicit 'Use when' trigger, natural keywords, and a distinct niche. Its main weakness is an under-specified 'what': it tells the reviewer to validate browser-facing markup but leaves the concrete criterion (scripts must load with defer/async/type=module) buried in an awkwardly embedded rule title.

Suggestions

Rewrite the what-clause to state the validation criterion explicitly, e.g. 'Validate that script tags in the final markup load with defer, async, or type=module rather than blocking HTML parsing.'

Replace the boilerplate phrase 'related to Load scripts with defer, async, or type=module' with natural trigger phrasing such as 'when reviewing script loading, render-blocking scripts, or page-load performance'.

DimensionReasoningScore

Specificity

The description names the domain ("templates, rendered HTML, or shared components") and two concrete actions ("reviewing" and "Validate the final browser-facing markup"), but coverage is not comprehensive — it never states the actual validation criterion (script tags must use defer/async/type=module). This matches the anchor for naming a domain with 1-2 concrete actions; it falls below 'several specific actions' and above the generic-minimal anchor.

3 / 5

Completeness

Both halves are present: an explicit "Use when reviewing templates, rendered HTML, or shared components..." trigger and a what-clause "Validate the final browser-facing markup, not just the source framework abstraction". Not a 5 because the 'what' is indirect — the actual rule being validated is only obliquely referenced via the rule title, and the trigger clause could name the user-facing scenarios (code review of rendered HTML) more directly.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "templates", "rendered HTML", "shared components", "defer, async, or type=module", "browser-facing markup". A few natural terms a user would say are missing (e.g. "script loading", "render-blocking scripts", "page load performance"), and the embedded title phrase "related to Load scripts with defer, async, or type=module" reads as boilerplate rather than natural phrasing — between the 'some relevant keywords' (3) and 'comprehensive with synonyms' (5) anchors.

4 / 5

Distinctiveness Conflict Risk

Clear niche — script loading attributes (defer/async/type=module) in rendered HTML review — with distinct trigger terms unlikely to collide with unrelated skills. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor; it is well above the 'mostly distinct, minor overlap' (4) anchor.

5 / 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.