CtrlK
BlogDocsLog inGet started
Tessl Logo

navigation-landmark

Use when reviewing templates, rendered HTML, or shared components related to Use navigation landmark regions. Validate the final browser-facing markup, not just the source framework abstraction.

57

Quality

66%

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/navigation-landmark/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 well structured for a short, single-purpose rule skill: a specific Check, a concrete Fix, and a clean pointer to a real one-level-deep reference file. Its weaknesses are mild redundancy — a concept-explaining intro and Quick Reference bullets that restate Check/Fix — and the absence of any inline markup example, with skip-link guidance mentioned but not covered in the Check/Fix workflow.

Suggestions

Delete the intro sentence explaining what navigation landmarks do and the redundant Quick Reference bullets that restate Check/Fix; keep the quick reference only for items (like skip links) not covered elsewhere.

Add a short inline HTML snippet of a correctly labeled nav region (nav with aria-label and a skip link) so the Fix is copy-paste ready without opening the reference file.

Fold skip links into the Check and Fix sections (e.g. "Verify a skip link precedes the nav and points to the main content") so the stated workflow covers everything the Quick Reference promises.

DimensionReasoningScore

Conciseness

The body is short and mostly tight, but the intro sentence explains a concept Claude already knows ("Navigation landmarks allow screen reader users to quickly jump to and identify different navigation areas—without them, users must tab through every link") and the Quick Reference bullets largely duplicate the Check and Fix sections ("Wrap navigation links in nav elements", "Use aria-label..." appear twice). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level of 4.

3 / 5

Actionability

As an instruction-only skill the guidance is concrete: "Verify navigation areas use nav elements with aria-label or aria-labelledby to distinguish primary, secondary, and footer navigation" and "descriptive aria-labels like 'Main navigation' or 'Footer navigation'" give specific elements, attributes, and example values. It is not 5 because the body contains no actual markup snippet — the code example is deferred entirely to references/rule.md, leaving a minor gap for the common cases.

4 / 5

Workflow Clarity

This is a simple single-task skill whose core action is unambiguous (check nav elements with distinguishing aria-labels in rendered markup), organized into Check/Fix/Explain/Code Review. However, "Provide skip links to bypass repetitive navigation" appears in Quick Reference yet is absent from both the Check and Fix sections, a minor coverage gap that keeps it below the fully unambiguous level of 5.

4 / 5

Progressive Disclosure

The body is a true overview and the full implementation details (code examples, framework guidance) live in references/rule.md, verified to exist, one level deep, and clearly signaled: "For full implementation details, code examples, and framework-specific guidance, see references/rule.md." This matches the 'clear overview with well-signaled one-level-deep references; content appropriately split' anchor exactly.

5 / 5

Total

16

/

20

Passed

Description

62%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 appropriate trigger clause and a niche focus, but its 'what' is awkwardly stitched into the rule title ("related to Use navigation landmark regions") and it omits the natural accessibility vocabulary (screen reader, aria, nav) users would most likely say. It lands above the midpoint but well short of the exemplary anchors.

Suggestions

State the 'what' as concrete actions instead of leaning on the rule title, e.g. "Validates that navigation areas use nav elements with aria-label/aria-labelledby and skip links. Review templates, rendered HTML, or shared components and flag violations in the final browser-facing markup, not the framework abstraction."

Add the natural trigger terms users say for this need — "accessibility", "screen reader", "nav elements", "aria-label", "a11y" — to the 'Use when' clause so the skill surfaces for accessibility reviews.

Fix the grammar of "related to Use navigation landmark regions" (the capitalized verb reads as a pasted title) so the domain reads as a noun phrase.

DimensionReasoningScore

Specificity

The description names the domain ("Use navigation landmark regions") and one concrete action ("Validate the final browser-facing markup, not just the source framework abstraction"), but does not enumerate the actual capabilities such as checking nav elements, aria-labels, or skip links. It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor rather than the 'several specific actions' anchor at 4.

3 / 5

Completeness

An explicit "Use when reviewing templates, rendered HTML, or shared components" clause answers 'when', and "Validate the final browser-facing markup" provides a 'what', but the actual task is garbled into "related to Use navigation landmark regions" rather than cleanly stated. It has both what and when with the 'when' explicit but the 'what' weakly conveyed — the anchor 4 fit, not the fully concrete anchor 5.

4 / 5

Trigger Term Quality

"templates, rendered HTML, or shared components" are reasonable developer triggers, but the most natural phrases a user would say for this need — "accessibility", "screen reader", "nav", "aria-label", "a11y" — are entirely absent. This matches the 'some relevant keywords but missing common variations or synonyms' anchor, below the 'good keyword coverage' anchor at 4.

3 / 5

Distinctiveness Conflict Risk

The navigation-landmark focus and rendered-markup scope give it a clear niche, though the boilerplate "Use when reviewing templates, rendered HTML, or shared components" prefix would also match sibling HTML/accessibility rule skills. This is 'mostly distinct; minor overlap risk with closely related skills', not the anchor 3 level of unresolved overlap, because the rule name explicitly distinguishes the trigger.

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