CtrlK
BlogDocsLog inGet started
Tessl Logo

html-xml-lang-mismatch

Use when applies to XHTML documents and polyglot HTML documents that must parse correctly as both HTML5 and XML. For modern HTML5-only documents, only `lang` is needed and `xml:lang` is not required. Check when auditing documents served as application/xhtml+xml or documents that include both attributes.

63

Quality

75%

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/html-xml-lang-mismatch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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, actionable audit guide with excellent progressive disclosure and an unambiguous check-fix workflow. Its main weakness is redundancy: the Quick Reference and Explain sections repeat the Check/Fix content, and the generic Code Review boilerplate adds tokens without rule-specific value.

Suggestions

Trim redundancy: the Quick Reference bullets duplicate Check/Fix content and WCAG SC 3.1.1 is cited twice — consolidate into one place.

Replace the generic Code Review boilerplate ("roles, labels, focus behavior, or keyboard interactions") with guidance specific to language attributes, e.g. how to re-inspect the html element after the fix.

Consider pulling one correct/incorrect markup example from references/rule.md inline to make the Check section fully self-contained.

DimensionReasoningScore

Conciseness

Mostly efficient, but with noticeable redundancy: the Quick Reference bullets largely restate the Check and Fix sections, WCAG 2.1 SC 3.1.1 is cited twice (Quick Reference and Explain), and the Code Review section's boilerplate about "roles, labels, focus behavior, or keyboard interactions" is irrelevant to language attributes. This is more than the minor trimming of anchor 4, though far from the heavy padding of anchor 2.

3 / 5

Actionability

Concrete, executable audit guidance: inspect the <html> element, verify values are identical including subtags (with the en vs en-US edge case called out), validate the BCP 47 tag with example codes, and document-type-specific fixes (remove xml:lang for text/html, keep both for polyglot). Minor gap: the code examples live only in references/rule.md rather than inline, keeping it just below fully copy-paste-ready.

4 / 5

Workflow Clarity

This is a simple, single-purpose audit skill and the Check → Fix → Explain sequence is unambiguous, including how to verify the fix with accessibility tooling in the Code Review section. No destructive or batch operations, so no validation checkpoint is required.

5 / 5

Progressive Disclosure

The body is a concise overview that clearly signals a single one-level-deep reference ("For full implementation details, code examples, and framework-specific guidance, see references/rule.md"), and that file exists and contains exactly the promised details and examples. Structure is clean and easy to navigate.

5 / 5

Total

17

/

20

Passed

Description

73%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 strong, explicit trigger guidance and a well-scoped niche, but under-specifies the capability itself: beyond the vague verb "Check", it never states that the skill detects or flags mismatched lang/xml:lang values. Stating the concrete action would raise specificity and completeness.

Suggestions

State the concrete capability explicitly, e.g. "Verifies that lang and xml:lang attributes on the html element have identical, valid BCP 47 values and flags mismatches" — this would lift specificity and completeness.

Include the keyword "mismatch" (or "language mismatch") so users describing the problem in their own words can trigger the skill.

Fix the grammatically broken opening clause "Use when applies to XHTML documents" — it is missing a subject (e.g. "Use when the rule applies to...").

DimensionReasoningScore

Specificity

The description names a concrete domain (lang/xml:lang on XHTML and polyglot HTML documents, with the application/xhtml+xml MIME type) but its only action verbs are "Check when auditing" — the actual capability (verifying the attribute values match, flagging mismatches) is never stated. It sits between anchor 3 and anchor 4: domain plus 1-2 actions, but not several specific actions.

3 / 5

Completeness

Both parts are explicitly present: the 'what' ("Check when auditing documents served as application/xhtml+xml or documents that include both attributes") and the 'when' (two explicit trigger clauses covering XHTML, polyglot documents, and documents with both attributes). Below a 5 because the word "mismatch" never appears — what exactly to check for is implied rather than clearly stated.

4 / 5

Trigger Term Quality

Good keyword coverage: "XHTML documents", "polyglot HTML documents", "HTML5", "XML", "application/xhtml+xml", "lang", "xml:lang" are terms a user auditing this issue would naturally say. Missing common natural variations like "language mismatch", "document language", or "i18n", so it falls short of the comprehensive synonym coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (lang/xml:lang agreement in XHTML/polyglot documents) with distinct triggers (application/xhtml+xml serving, presence of both attributes) and minimal risk of firing for an unrelated skill.

5 / 5

Total

16

/

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.