CtrlK
BlogDocsLog inGet started
Tessl Logo

empty-links

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Fix empty and broken links. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

60

Quality

71%

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/empty-links/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.

The body is a well-structured overview with actionable check/fix instructions and exemplary progressive disclosure to a single real reference file. Its main weaknesses are redundant sections (the duplicated screen-reader sentence and the templated Code Review paragraph) and the absence of any executable verification step in the body itself. Above-average quality with clear trimming opportunities.

Suggestions

Delete either the opening paragraph or the "Explain" section — both state the identical screen-reader sentence almost verbatim, a pure token cost.

Merge the "Quick Reference" bullets into "Check"/"Fix" so each fact appears once, and replace the templated "Code Review" paragraph with a concrete verification step (e.g. "After fixing, re-run the check; confirm with axe DevTools or Lighthouse as shown in references/rule.md").

Inline one minimal executable check — the four-line browser-console querySelectorAll snippet from references/rule.md — so the "Check" section can be executed directly from the body.

DimensionReasoningScore

Conciseness

Mostly efficient prose, but there is real duplication: the opening sentence "Screen readers announce empty links as just 'link' with no context..." is repeated nearly verbatim in the "Explain" section, several "Quick Reference" bullets restate the "Fix" section, and the "Code Review" section is templated prose adding little beyond the description. Fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances', since the redundancy spans multiple sections.

3 / 5

Actionability

Concrete, specific guidance throughout: "Verify all links have accessible names via text content, aria-label, or aria-labelledby", "For icon-only links, add aria-label describing the destination. Use visually-hidden text if visible labels are not desired. Remove or fix broken links." Per the rubric's code-vs-instruction note, absent code is not penalized for an instruction-only skill when guidance is actionable — and it is. Not a 5 because the body itself offers no executable check (the console snippet and axe/Lighthouse commands live only in references/rule.md), leaving minor gaps in the "how to scan" step.

4 / 5

Workflow Clarity

A clear Check → Fix sequence with detection criteria up front, and verification is addressed ("note how to verify the fix with browser accessibility tooling or assistive tech", with concrete verification steps in references/rule.md). Fits anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') — the re-check loop after fixing is implied rather than an explicit step, which keeps it below anchor 5. Not a destructive or batch operation, so the cap at 3 does not apply.

4 / 5

Progressive Disclosure

The body is a lean overview organized into scannable sections (Quick Reference / Check / Fix / Explain / Code Review), and it cleanly delegates the bulk material — full HTML/CSS/React examples, the console detection script, and verification tooling — to a single, clearly signaled, one-level-deep pointer: "For full implementation details, code examples, and framework-specific guidance, see references/rule.md", which was verified to exist and contain exactly that content. Matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split').

5 / 5

Total

16

/

20

Passed

Description

71%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 trigger clause and a concrete list of inspection actions, but it describes only the review process while leaving the fix capabilities implied by the embedded rule name, and its generic 'rendered HTML / interactive components / design-system patterns' boilerplate creates overlap risk with sibling accessibility skills. Solid mid-to-upper-range quality with identifiable tightening opportunities.

Suggestions

Replace the generic 'reviewing rendered HTML, interactive components, or design-system patterns' trigger boilerplate with rule-specific triggers, e.g. 'Use when an anchor tag has no text content, an icon-only link lacks an aria-label, or a link points to a broken destination' — this reduces conflict with sibling accessibility skills.

State the fix actions explicitly in the description (e.g. 'add accessible text, aria-label, or visually-hidden text to empty links and repair broken hrefs') so the "what" is stated as capability rather than only inspection steps.

Add the natural synonyms users actually type — "aria-label", "icon link", "anchor" — to the trigger terms to round out keyword coverage.

DimensionReasoningScore

Specificity

Lists several concrete inspection actions — "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" — but only covers the review side; the actual fix actions (add accessible text, aria-label, repair hrefs) are never stated, a minor coverage gap. Fits anchor 4 ('several specific actions; minor gaps') rather than 5, which requires comprehensive coverage of the skill's capabilities, and clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both parts are present: the "what" via the inspection actions ("Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output") and an explicit "Use when reviewing rendered HTML..." trigger clause. Falls short of anchor 5 because the "what" leans on the embedded rule name rather than explicitly stating the skill's fix capabilities, and short of a 5-level concrete trigger-phrase list. The explicit 'Use when...' clause rules out the cap at 3.

4 / 5

Trigger Term Quality

Natural phrases like "Fix empty and broken links", "rendered HTML", "screen-reader output", "accessible names", and "keyboard behavior" are terms users would plausibly say when they need this skill. Not a 5 because common synonyms users would actually type — "aria-label", "icon link", "anchor tag" — are absent; not a 3 because the core natural terms (empty links, broken links) are present.

4 / 5

Distinctiveness Conflict Risk

The distinguishing hook "related to Fix empty and broken links" is specific, but the boilerplate trigger "reviewing rendered HTML, interactive components, or design-system patterns" is generic review language shared by virtually any accessibility- or markup-review skill, so it could fire for sibling rules (empty buttons, missing alt text, broken focus order). Overlap risk with closely related skills is real but not severe — fits anchor 3, below anchor 4's 'minor overlap risk with closely related skills'.

3 / 5

Total

15

/

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.