page-title-and-language
Skill0 starsChanged 29 days agoMITView on GitHub
Use when the browser tab or screen reader announces the wrong page, when every page shares one title, when a single-page app never updates the title, or when text is read aloud in the wrong language or accent.
In this repository33 other files it gives its agents.
- AGENTS.mdAGENTS.md
- accessible-authenticationSkill
- accessible-formsSkill
- accessible-nameSkill
- accordion-disclosureSkill
- audit-componentSkill
- carouselSkill
- charts-and-datavizSkill
- combobox-autocompleteSkill
- data-tableSkill
- email-html-accessibilitySkill
- fix-color-contrastSkill
- forced-colors-and-dark-modeSkill
- headings-and-landmarksSkill
- keyboard-focusSkill
- live-regionsSkill
- media-captionsSkill
- menu-buttonSkill
- modal-dialogSkill
- motion-and-animationSkill
- pagination-and-searchSkill
- pointer-and-gesturesSkill
- predictable-contextSkill
- progress-and-loadingSkill
- screen-reader-test-planSkill
- semantic-htmlSkill
- skip-linksSkill
- svg-and-iconsSkill
- tabsSkill
- tooltip-popoverSkill
- triage-automated-resultsSkill
- wcag22-new-criteriaSkill
- zoom-reflow-text-spacingSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 93
When a route swaps the visible content, ensure the heading that names the new view is present and the landmarks are not duplicated.
- Distinctive: line 102
Check the three facts in the accessibility tree, per route, not once at load.
- Very specific: line 136
Read the title and language aloud with a screen reader: NVDA reads the title on focus of the window and the document language determines …
- Very specific: line 146
The title that only names the site: Every route is Acme or Acme Billing.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Page title and language
Criteria: SC 2.4.2 Page Titled, SC 3.1.1 Language of Page, SC 3.1.2 Language of Parts, SC 1.3.1 Info and Relationships
The title and the lang attributes are the two pieces of metadata a screen reader
consumes before it reads a single word, and both are trivial to ship wrong. The
failure that matters most is a single-page app whose <title> stays on the value
from first load, because every automated scanner sees a non-empty title and passes
it while the user hears the wrong page name on every route change.
When to use
- The tab says "Home" or the app name on every route.
- A dynamic view (search results, a product, an invoice) has a static title.
- A screen reader reads an English word with a French or German pronunciation, or reads a French phrase with English phonetics.
- The document has no
lang, orlang="en"on a page whose content is not English. - Text is switched to right-to-left and the layout or punctuation breaks.
- An SPA route change updates the view and announces nothing.
Procedure
- Put a title on every page, and make it specific and front-loaded
(SC 2.4.2). The title must describe the topic or purpose. Put the unique part
first, because tab strips, screen reader lists and browser lists truncate:
Invoice 4821 — Acme Billing, notAcme Billing — Invoice 4821. Update
document.titleon every route and view change (SC 2.4.2). In an SPA the title is not re-derived by navigation. Set it where you set the view. Pair it with a focus move or a live-region announcement if the content changes, or the user is told the new name but stays on the old content.// Fails SC 2.4.2 in an SPA — set once at startup and never again. document.title = 'Acme Billing'; // Passes — each route owns its title, and the change is announced. function render(route) { document.title = `${route.title} — Acme Billing`; app.replaceChildren(route.view()); main.focus(); // moves the reading position to the new content }Mark the language of the page on the root element (SC 3.1.1). The value is a BCP 47 language tag. Without it, a screen reader guesses, and the guess is usually the user's default voice rather than the content's actual language.
<!-- Fails SC 3.1.1 — no language, so assistive technology guesses --> <html> <!-- Passes — the page language is declared in the markup, not by a plugin --> <html lang="en">Mark the language of parts that differ from the page (SC 3.1.2). Every passage or phrase in a language other than the page's needs its own
langon the nearest containing element — the inline phrase, the quote, or the block. SC 3.1.2 has an exception: a single word or phrase that a speaker would not distinguish, such as a proper noun or a term already standardized in the page's language, does not need a tag.<!-- Fails SC 3.1.2 — a French quotation read with English phonetics --> <blockquote> La trahison des clercs is the phrase Benda made famous. </blockquote> <!-- Passes — the distinctive phrase carries its own language --> <blockquote> <span lang="fr">La trahison des clercs</span> is the phrase Benda made famous. </blockquote>Set direction when the language implies it (SC 1.3.1, SC 3.1.2).
dir="rtl"belongs on the element whose content is right-to-left; thedirattribute and thelangattribute are separate concerns, and a correctlangwithoutdirproduces reordered punctuation and mangled numbers.<!-- Passes — language and direction travel together on the island --> <p lang="ar" dir="rtl">مرحبا بالعالم</p>- Keep the structure beneath the title honest (SC 1.3.1). The title names the page, but the page's real structure is carried by its landmarks and headings. When a route swaps the visible content, ensure the heading that names the new view is present and the landmarks are not duplicated.
- Do not rely on
<title>alone as a label. A button or frame that must be named usesaria-labelor visible text, not thetitleattribute. Thetitleattribute is not reliably announced and does not appear on touch devices.
Verify
Check the three facts in the accessibility tree, per route, not once at load.
// SC 2.4.2 and SC 3.1.1 — run after every route change, not only at startup.
const title = document.title.trim();
const lang = document.documentElement.lang;
const uniqueEnough = title.length > 0 && !/^(home|index|app|acme)$/i.test(title);
console.log({ title, lang, uniqueEnough });
if (!lang) console.warn('SC 3.1.1: no lang on <html>');// SC 3.1.2 — find text nodes whose language differs from the page but carries no
// lang attribute. This is a heuristic; confirm each hit by reading it aloud.
function unmarkedForeignText(root = document.body) {
const pageLang = (document.documentElement.lang || '').split('-')[0].toLowerCase();
const out = [];
const walk = (node) => {
for (const child of node.childNodes) {
if (child.nodeType === Node.TEXT_NODE) {
const text = child.textContent.trim();
const inTagged = child.parentElement?.closest('[lang]');
if (text && !inTagged) out.push({ text: text.slice(0, 60), lang: pageLang });
} else if (child.nodeType === Node.ELEMENT_NODE) {
walk(child);
}
}
};
walk(root);
return out;
}
console.log(unmarkedForeignText());Read the title and language aloud with a screen reader: NVDA reads the title on
focus of the window and the document language determines the synthesizer voice.
Switching voices mid-sentence is the signal that lang is right or wrong; that
part is judgement, and no scanner makes it for you.
Failure modes
- The SPA title that never changes.
index.htmlships<title>Acme</title>and nothing rewrites it. Axe reports a pass because the title is present and non-empty. - The title that only names the site. Every route is
AcmeorAcme Billing. The title describes the site, not the page, which fails the "topic or purpose" part of SC 2.4.2 even though it is non-empty. langon<html>but nothing on foreign passages. A mostly-English site quotes a German paragraph and a screen reader pronounces it as English. This is the SC 3.1.2 failure that ships most often, because the page-level tag is correct and the page-level check passes.lang="en-US"mismatch, or an invalid tag.lang="eng",lang="English"or a two-letter tag on a language that needs a script subtag (zh-Hansvszh-Hant) makes the synthesizer guess. Use a valid BCP 47 tag.dirused withoutlang, orlangwithoutdir. Switching todir="rtl"on an element but leaving the language English gives English pronunciation with RTL layout; the reverse gives the right voice with LTR layout and misplaced punctuation.- Overcorrection: wrapping every foreign proper noun. Putting
lang="fr"on "Paris" orlang="de"on a brand name in otherwise English prose makes the synthesizer stumble on the one word it would have read correctly. SC 3.1.2 explicitly exempts single words and phrases that need no distinction. - Using the
titleattribute as the page's or control's name. It is not reachable by keyboard or touch and is announced inconsistently, so it does not satisfy SC 2.4.2 or SC 1.3.1 in practice.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

