skills.rest
leobrival
leobrivalCOMMUNITY
Explore all skills by this author →
GitHub

check-headings

Analyze HTML heading hierarchies and report structural issues.

Updated Aug 27, 2026
Search Tags:#SEO#accessibility#HTML#analyze#headings#H1
One-click install
npx skills add https://github.com/leobrival/serum-plugins-official --skill check-headings
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: check-headings
Source: https://github.com/leobrival/serum-plugins-official/tree/main/plugins/html-checker/skills/check-headings
Command: npx skills add https://github.com/leobrival/serum-plugins-official --skill check-headings

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

HTML heading structure issues affect accessibility and SEO. This Skill analyzes and validates the H1-H6 hierarchy on a given web page to surface structural problems.

Core Features & Use Cases

  • H1 health checks: Detects missing or multiple H1 headings.
  • Hierarchy validation: Flags skipped heading levels and invalid order to improve accessibility and search optimization.
  • Page audit utility: Helps QA teams and content editors ensure consistent heading structure across pages.

Quick Start

Run the heading checker from the scripts directory: cd /path/to/html-checker/scripts bun src/check-headings.ts https://example.com

Frequently Asked Questions about check-headings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my HTML heading structure for accessibility issues?▼

You can validate your HTML heading structure by running an analysis tool via bun in the scripts directory with a target URL, which outputs a report flagging skipped levels, missing H1s, and incorrect order.

What is an invalid HTML heading hierarchy and how does it affect SEO?▼

An invalid HTML heading hierarchy occurs when H1-H6 levels are skipped or multiple H1s exist. This damages SEO and accessibility by confusing screen readers and search engines about content structure.

How do I detect missing or multiple H1 tags on a web page?▼

Detect missing or multiple H1 tags by passing a URL to the heading checker script. It returns a structured report identifying these specific issues alongside a heading hierarchy visualization.

Can I audit heading structure on SPA routes using this script?▼

Yes, you can apply the heading structure analysis to SPA routes. The script evaluates the rendered page content to detect empty headings and incorrect order for accessibility improvements.

Does the heading checker require any external dependencies to run?▼

No external dependencies are required to run the heading checker. It operates independently using bun within the scripts directory to analyze URLs and output the structural validation report.

What is the best way to visualize skipped heading levels for QA teams?▼

The best way to visualize skipped heading levels is using an automated analysis script that outputs a structured hierarchy visualization, helping QA teams quickly spot invalid order and empty headings.

Related Skills

Explore More Software Engineering Skills→
cocyuhaococyuhao
1

web-scraper

Fetch HTML from a URL and convert it to clean Markdown.

Community
Intermediate
pluginagentmarketplacepluginagentmarketplace
3

red-team-reporting

Generate security assessment reports from structured findings in Markdown, HTML, PDF, or DOCX.

Community
Basic
Nhqvu2005Nhqvu2005
54

seo-analyzer

Analyze HTML/JSX files for essential SEO meta tags and alt text.

Community
Basic
Sir-chawakornSir-chawakorn
9

debug-frontend-browser

Inspect console logs, network traffic, and DOM state to diagnose runtime UI bugs.

Community
Advanced