check-headings

Analyze HTML heading hierarchies and report structural issues.

Updated Aug 27, 2026

Search Tags:#SEO #accessibility #HTML #analyze #headings #H1

Ready to run

npx skills add https://github.com/leobrival/serum-plugins-official --skill check-headings

💬 Prompt for ChatGPT / Claude Chat▼

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.