html5-semantic-elements SKILL.md skillA

html5-semantic-elements from thedaviddias/front-end-checklist is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add thedaviddias/front-end-checklist/html5-semantic-elements@git:20261004.4b0ddb9

Pins git:20261004.4b0ddb9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
thedaviddias/front-end-checklist
Path
skills/html5-semantic-elements/SKILL.md
Versions recorded
2
Latest version
git:20261004.4b0ddb9, committed Oct 4, 2026
First version recorded
May 29, 2026
Size
1,796 bytes
Repository stars
74,516
License
MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Use semantic HTML elements

Screen readers use semantic elements to navigate pages—users can jump directly to <main> content or <nav>. Search engines also use semantics to understand content hierarchy.

## Quick Reference

- Use <header>, <main>, <footer> for page structure
- Use <article> for self-contained content, <section> for grouped content
- Use <nav> for navigation, <aside> for related/sidebar content
- Only one <main> per page, but multiple <header>/<footer> allowed

## Check

Review this HTML structure to ensure it uses appropriate semantic elements like header, main, section, article, aside, and footer instead of generic div elements.

## Fix

Replace generic div elements with semantic HTML5 elements that accurately describe the content structure and purpose.

## Explain

Explain how semantic HTML elements improve accessibility, SEO, and code maintainability by providing meaningful structure to web content.

## Code Review

Review templates, server-rendered HTML, and shared components that output markup related to Use semantic HTML elements. Flag exact elements, attributes, and routes where the rendered HTML violates the rule.

---
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add thedaviddias/front-end-checklist/html5-semantic-elements@sha256:7cfe73c3fe29b40b

The line at the top of this page pins the label git:20261004.4b0ddb9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jkb64w4cafdhkozg.svg)](https://markdownregistry.com/a/art_jkb64w4cafdhkozg)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between May 29, 2026 and Oct 4, 2026, about one every 128 days.

versioncommittedcommitsizeaudit
git:20261004.4b0ddb9 latest2026-10-04 4b0ddb9 1,796 BA view · diff
git:20260529.7c059042026-05-29 7c05904 1,802 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1796 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

thedaviddias/front-end-checklist · 74,516 stars · license MIT · pushed 2026-10-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jkb64w4cafdhkozg
GET https://markdownregistry.com/api/v1/resolve?ref=thedaviddias/front-end-checklist/html5-semantic-elements
GET https://markdownregistry.com/api/v1/blob/7cfe73c3fe29b40b08b507646d8d6daa1affd6d6b2a11c0c4f944eeb472f68c0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from thedaviddias/front-end-checklist

AGENTS.md AGENTS.md file
thedaviddias/front-end-checklist · AGENTS.md
git:20260930.d3ad6b7 · audit A · 74,516 stars
CLAUDE.md CLAUDE.md file
thedaviddias/front-end-checklist · CLAUDE.md
git:20260602.065968e · audit A · 74,516 stars
frontendchecklist SKILL.md skill
thedaviddias/front-end-checklist · packages/cli/SKILL.md · Review frontend code and live pages against the Front-End Checklist (380+ rules for accessibility, performance, SEO…
git:20261001.9b4f0d0 · audit A · 74,516 stars
frontend-checklist-global SKILL.md skill
thedaviddias/front-end-checklist · plugins/front-end-checklist/skills/frontend-checklist-global/SKILL.md · Use when auditing or improving any frontend codebase against the full Front-End Checklist rule corpus through one entry…
git:20261004.4b0ddb9 · audit A · 74,516 stars
404-page SKILL.md skill
thedaviddias/front-end-checklist · skills/404-page/SKILL.md · Use when reviewing templates, rendered HTML, or shared components related to Create a custom 404 error page. Validate…
git:20260529.7c05904 · audit A · 74,516 stars
about-page SKILL.md skill
thedaviddias/front-end-checklist · skills/about-page/SKILL.md · Use when auditing metadata, crawlability, structured data, or indexability related to Create a dedicated About page…
git:20260529.7c05904 · audit A · 74,516 stars
accessibility-testing SKILL.md skill
thedaviddias/front-end-checklist · skills/accessibility-testing/SKILL.md · Use when reviewing component libraries, page flows, or CI pipelines that need repeatable accessibility checks…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-authentication SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-authentication/SKILL.md · Use when reviewing sign-in, sign-up, MFA, CAPTCHA, recovery, and re-auth flows. Evaluate the full authentication path…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-notifications SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-notifications/SKILL.md · Use when reviewing templates, rendered HTML, or shared components related to Make notifications accessible. Validate…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-tables SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-tables/SKILL.md · Use when reviewing rendered HTML, interactive components, or design-system patterns related to Use semantic table…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-tooltips SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-tooltips/SKILL.md · Use when reviewing templates, rendered HTML, or shared components related to Create accessible tooltips. Validate the…
git:20260529.7c05904 · audit A · 74,516 stars
accesskeys SKILL.md skill
thedaviddias/front-end-checklist · skills/accesskeys/SKILL.md · Use when reviewing rendered HTML, interactive components, or design-system patterns related to Ensure accesskey values…
git:20260529.7c05904 · audit A · 74,516 stars

Every file in thedaviddias/front-end-checklist

Browse by kind, by grade A, or by owner.