CtrlK
BlogDocsLog inGet started
Tessl Logo

web-quality-audit

Comprehensive web quality audit covering performance, accessibility, SEO, and best practices. Use when asked to "audit my site", "review web quality", "run lighthouse audit", "check page quality", or "optimize my website".

60

Quality

70%

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/web-quality-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured and dense, but it duplicates web-quality knowledge Claude already has, gives abstract rather than executable workflow steps, and fails to surface the bundled analyze.sh script. Tightening the inline checklists into referenced files and wiring the analyzer script into the workflow would lift the weaker dimensions.

Suggestions

Reference and invoke scripts/analyze.sh in the 'How it works' workflow (e.g. 'Run scripts/analyze.sh <target> for automated HTML checks') so the bundled tool is actually used and findings are verifiable.

Split the four audit categories (Performance, Accessibility, SEO, Best Practices) into one-level-deep reference files (e.g. references/performance.md) and keep SKILL.md as a concise overview with clearly signaled links, instead of inlining all ~150 checks.

Replace the abstract 'How it works' steps with a concrete sequence that includes a validation checkpoint (run analyzer -> review findings -> re-run after fixes), and trim the well-known threshold restatements to only the non-obvious values.

DimensionReasoningScore

Conciseness

The body is prose-lean (bulleted checklists, no explanatory padding) but ~165 lines largely restate Lighthouse's own categories and well-known thresholds (LCP<2.5s, INP<200ms, CLS<0.1, WCAG 4.5:1, POUR) that Claude already knows, so not every token earns its place; this fits anchor 2 ("mostly efficient but could be tightened") better than the every-token-earns-its-place bar of 3.

2 / 3

Actionability

It provides a concrete output template and severity table, but the "How it works" steps are abstract ("Analyze the provided code/project", "Provide specific actionable recommendations") with no executable commands or code, and critically it never references the bundled scripts/analyze.sh; this matches anchor 2 ("some concrete guidance but incomplete; missing key details") rather than the copy-paste-ready level of 3 or the purely-descriptive level of 1.

2 / 3

Workflow Clarity

The four numbered "How it works" steps and audit-output template give a recognizable sequence, but there is no explicit validation/verification checkpoint and the bundled analyzer script is not wired into the flow, matching anchor 2 ("steps listed but validation gaps; checkpoints missing or implicit"); it is above 1 (steps are present) but below 3 (no explicit validate-and-retry feedback loop).

2 / 3

Progressive Disclosure

There are no references/ or assets/ bundle files; the four audit categories are all kept inline in one ~165-line file (content that could be split into per-category reference files), and the only References section points to sibling SKILL.md files rather than bundle materials, fitting anchor 2 ("some structure but content that should be separate is inline"); it is not the monolithic/nested-2+-levels case of 1 nor the well-signaled one-level-deep split of 3.

2 / 3

Total

8

/

12

Passed

Description

90%Weight 40%Scale 1-3

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 cleanly answers both what the skill does and when to use it, with natural third-person voice and strong user-facing trigger phrases. Its only weakness is that capabilities are stated as abstract categories rather than concrete actions.

DimensionReasoningScore

Specificity

Names the domain and the four audit categories ("performance, accessibility, SEO, and best practices") but uses the abstract verb "covering" rather than listing concrete actions like extract/merge/fill; anchor 2 ("Names domain and some actions, but not comprehensive") is the closest match, and it lacks the multiple specific concrete actions required for a 3.

2 / 3

Completeness

It explicitly states what ("Comprehensive web quality audit covering performance, accessibility, SEO, and best practices") and when (an explicit "Use when..." trigger clause), satisfying the anchor 3 requirement for both; it is above 2 because the when is explicit, not merely implied.

3 / 3

Trigger Term Quality

The clause "Use when asked to 'audit my site', 'review web quality', 'run lighthouse audit', 'check page quality', or 'optimize my website'" gives good coverage of natural phrases a user would actually say, matching the anchor 3 example; it is not the bare/jargon level of 1 or the partial-coverage level of 2.

3 / 3

Distinctiveness Conflict Risk

The Lighthouse/web-quality niche and triggers like "run lighthouse audit" are distinct and unlikely to fire for unrelated skills; although "optimize my website" is somewhat broad, the overall niche is clear enough for anchor 3 rather than the overlapping-skill level of 2.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 suspicious

Warning

Total

15

/

16

Passed

Repository
addyosmani/web-quality-skills
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.