CtrlK
BlogDocsLog inGet started
Tessl Logo

landmark-one-main

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

64

Quality

77%

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/landmark-one-main/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 split skill body: the Check/Fix guidance is concrete and rule-specific, and progressive disclosure is exemplary with a verified, clearly signaled one-level-deep reference. The main drag is token efficiency — known-concept explanation, a redundant bullet, and generic boilerplate sections pad an otherwise lean document.

Suggestions

Drop the opening sentence explaining why the main landmark matters and the redundant Quick Reference bullet 'Provides a clear starting point for the page's primary content' — Claude already knows this; keep only rule-specific guidance.

Tighten the Explain and Code Review sections into single imperatives (e.g., 'Explain why multiple main landmarks confuse assistive-tech users') instead of full-sentence generic boilerplate.

Add a concrete counting example to the Check section, such as `document.querySelectorAll('main, [role="main"]').length`, so the check is copy-paste executable in the body itself.

DimensionReasoningScore

Conciseness

The Check and Fix sections are tight, but the body includes unnecessary explanation Claude already knows — 'A single main landmark allows keyboard and screen reader users to jump directly to the primary content of the page, bypassing repetitive navigation' — plus a redundant Quick Reference bullet ('Provides a clear starting point for the page's primary content') that repeats it, and wordy boilerplate in the Explain and Code Review sections. It is mostly efficient but could be noticeably tightened, matching anchor 3 better than 4.

3 / 5

Actionability

Concrete, executable instructions are present: 'Count the number of <main> elements or elements with role='main' on the page' and 'Combine multiple main content areas into a single <main> element or remove the 'role=main' attribute from extra containers.' It is not a 5 because no example selector or command for the counting check is given and the Explain/Code Review sections are generic directives rather than rule-specific guidance.

4 / 5

Workflow Clarity

For this simple single-rule skill, the Check → Fix → Explain sequence is clear and the single action (verify exactly one main landmark) is unambiguous, with verification mentioned ('note how to verify the fix with browser accessibility tooling or assistive tech'). It is not a 5 because explicit validation steps are deferred to references/rule.md's Verification section rather than stated or linked in the body's own workflow, leaving minor validation gaps.

4 / 5

Progressive Disclosure

The body is a concise overview and the single bundle file, references/rule.md (verified to exist), correctly holds the code examples, best practices, and verification details. The reference is well signaled — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — one level deep with easy navigation, matching the 5 anchor.

5 / 5

Total

16

/

20

Passed

Description

83%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 strong description that explicitly answers both what it does and when to use it, with concrete trigger contexts and domain-specific inspection terms. Its weaknesses are cosmetic: the templated capitalization of the embedded rule name reads awkwardly, and a few natural synonyms (accessibility, a11y, ARIA, main element) are absent.

DimensionReasoningScore

Specificity

The description lists several concrete inspection actions — 'Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant' — tied to a specific domain. It falls short of the 5 anchor because the awkwardly embedded rule title ('related to Use exactly one main landmark') leaves minor gaps in coverage rather than a comprehensive, cleanly phrased action list.

4 / 5

Completeness

Both parts are explicitly stated: the 'when' is a concrete 'Use when reviewing rendered HTML, interactive components, or design-system patterns related to...' clause, and the 'what' is 'Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.' This mirrors the 5-anchor structure of explicit what-and-when with concrete trigger phrases; it is not a 4 because neither half is missing or weakly implied.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'rendered HTML', 'interactive components', 'design-system patterns', 'keyboard behavior', 'focus flow', 'screen-reader output', and 'main landmark'. It is not a 5 because common variations and synonyms are missing — notably 'accessibility', 'a11y', 'ARIA', 'main element', and 'role=main' — so keyword coverage is good but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

The rule name 'Use exactly one main landmark' carves a clear niche with a distinct trigger ('main landmark'), so conflict risk is low. It is not a 5 because the boilerplate scope ('reviewing rendered HTML, interactive components, or design-system patterns') would be shared verbatim by sibling accessibility-rule skills from the same source, creating minor overlap risk among closely related skills.

4 / 5

Total

17

/

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.