CtrlK
BlogDocsLog inGet started
Tessl Logo

broken-links

Use when auditing metadata, crawlability, structured data, or indexability related to Resolve internal broken links. Verify the rendered HTML and HTTP response rather than relying only on source files.

56

Quality

65%

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/broken-links/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 body is well organized with a clean one-level reference to a real bundle file carrying the implementation detail, and it stays lean. Its weaknesses are executional: the Check step provides no concrete scanning method, and the workflow lacks an explicit validation checkpoint after fixes, leaving Claude to infer how to scan and how to confirm a link is resolved.

Suggestions

Add a concrete scanning method to the Check section — e.g. a wget --spider sweep, a curl status-check loop, or a named link-checker tool — so the scan step is executable rather than aspirational.

Insert an explicit validation step after Fix: re-request the fixed URL and confirm a 200 (or intended redirect) before considering the link resolved, forming a validate-and-retry loop.

Merge the redundant "Check" section into the Quick Reference bullets (they currently duplicate each other) to tighten the body and free tokens for the scanning method.

DimensionReasoningScore

Conciseness

The body is short (~30 lines) with clear section headers and mostly earns its tokens. It is not a 5 because of minor padding: the intro paragraph ("Internal broken links frustrate users and waste crawl budget by sending search engine bots to non-existent pages, potentially harming your site's SEO") explains consequences Claude already knows, and the "Check" section restates the first Quick Reference bullet. It is well above anchor 3, whose 'unnecessary explanation' would be more substantial.

4 / 5

Actionability

"Scan the website for any internal links that lead to 404 pages or server errors" states the goal but gives no method or command for scanning (no curl/wget --spider/link-checker invocation anywhere in the body), and "Update the broken link to the correct URL or remove it if the destination page no longer exists" is direction rather than executable guidance. Targets and decision rules are specific (404/5xx codes, navigation elements, update-or-remove), which keeps it above anchor 2, but the missing execution details prevent a 4.

3 / 5

Workflow Clarity

A sequence is present (Check → Fix → Explain → Code Review), but validation is implicit at best: "describe how to verify the final page output" defers verification instead of stating a checkpoint, and there is no re-verification step after fixing a link. Since fixing links across a site is a batch-style operation with no validate-and-retry loop, the anchor-3 cap applies; it is above anchor 2 because the steps themselves are well defined.

3 / 5

Progressive Disclosure

The body is a lean overview with clear section headers, and it points to exactly one reference — "see `references/rule.md`" — which exists and appropriately holds the deeper material (code example, why-it-matters, exceptions, verification procedures). The reference is one level deep, clearly signaled, and rule.md itself references nothing further, matching the anchor-5 pattern of a well-split, easily navigable bundle.

5 / 5

Total

15

/

20

Passed

Description

66%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 has an explicit and natural 'Use when' trigger and reasonable SEO keyword coverage, but its 'what' is awkwardly constructed by embedding the rule title ("related to Resolve internal broken links") instead of stating concrete capabilities, and its broad SEO trigger terms create overlap risk with sibling SEO skills. It reads as a template-stuffed description rather than a deliberately written one.

Suggestions

Rewrite the what-clause as plain third-person actions, e.g. "Detects and fixes internal links that return 404 or 5xx responses. Verifies the rendered HTML and HTTP response rather than relying only on source files." instead of the embedded "related to Resolve internal broken links" title phrasing.

Add natural trigger synonyms users would actually say: "404 errors", "dead links", "link checking", "link audit" — none of these currently appear.

Narrow the trigger list so general metadata/structured-data/indexability audits that are not about broken links do not fire this skill; lead with the broken-links-specific triggers.

DimensionReasoningScore

Specificity

The description names concrete actions — "auditing metadata, crawlability, structured data, or indexability" and "Verify the rendered HTML and HTTP response" — but stops at 1-2 actions without covering scanning, fixing, or reporting, and the action phrasing is muddied by the embedded rule title "related to Resolve internal broken links". It is above anchor 2 (which names only a domain with generic actions) but does not reach anchor 4's 'several specific actions with minor gaps'.

3 / 5

Completeness

Both parts are present: an explicit when ("Use when auditing metadata, crawlability, structured data, or indexability related to...") and a discernible what ("Resolve internal broken links" plus "Verify the rendered HTML and HTTP response rather than relying only on source files"). It is not a 5 because the 'what' is not cleanly stated as the skill's own actions — the rule title is pasted into a 'related to' clause rather than declaring what the skill does.

4 / 5

Trigger Term Quality

It carries solid natural SEO keywords — "metadata", "crawlability", "structured data", "indexability", "broken links", "rendered HTML", "HTTP response" — terms a user auditing SEO would actually say. It falls short of anchor 5 because common synonyms and error-code triggers are missing: no "404", "dead links", or "link checking".

4 / 5

Distinctiveness Conflict Risk

"Resolve internal broken links" is a distinct niche, but the leading trigger list ("auditing metadata, crawlability, structured data, or indexability") is shared vocabulary with sibling SEO-rule skills, so a request like 'audit my structured data' would fire this skill even when broken links are not the topic. It is more specific than anchor 2's broad overlap but does not achieve anchor 4's 'mostly distinct' positioning.

3 / 5

Total

14

/

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.