Content SEO

Heading Structure Analyzer

/heading-check

Analyze your page's heading hierarchy for SEO best practices. Checks H1-H6 structure, keyword placement, and heading length.

Get this skill

Install all free SEO skills with one command:

curl -fsSL https://raw.githubusercontent.com/ccforseo/seo-skills/main/install.sh | bash

Or install this skill manually:

$ git clone https://github.com/ccforseo/seo-skills.git
$ cp -r seo-skills/heading-analyzer ~/.claude/skills/heading-analyzer
View on GitHubFree · MIT License · 8 skills included

What it does

The Heading Structure Analyzer skill validates your page's heading hierarchy against SEO best practices. It checks for a single H1, proper H1-H6 nesting without skipped levels, keyword presence in headings, heading length, and duplicate headings. It also compares your heading structure against top-ranking pages for the same keyword to identify missing subtopics.

Key features

  • Validates H1-H6 hierarchy with no skipped levels
  • Checks for single H1 presence and keyword inclusion
  • Flags duplicate headings across the page
  • Compares heading structure against top SERP competitors
  • Suggests missing subtopics based on competitor analysis

How to use Heading Structure Analyzer

  1. Run the command

    Type /heading-check with a URL or paste your HTML content. Optionally provide a target keyword for keyword placement analysis.

  2. Review the hierarchy

    The output shows your heading tree with annotations for issues: skipped levels, missing keywords, duplicate text, or excessively long headings.

  3. Fix and compare

    Restructure your headings based on the recommendations. The competitor comparison shows subtopics you may want to add as new H2 or H3 sections.

When to use it

Auditing heading structure on existing content

Validating heading hierarchy before publishing

Finding missing subtopics by comparing against competitors

Training content teams on proper heading usage

Frequently asked questions

Why does heading hierarchy matter for SEO?

Search engines use headings to understand page structure and topic hierarchy. Proper nesting (H1 > H2 > H3) signals clear content organization. Skipped levels (H1 > H3) or multiple H1s confuse this signal and can reduce content visibility.

Should I use keywords in every heading?

Include your primary keyword in the H1 and at least one H2. Use related keywords and natural language in other headings. Forcing keywords into every heading reads unnaturally and provides diminishing returns.

How many H2 headings should a page have?

There is no fixed rule, but most well-performing articles have 4-8 H2 sections. The skill compares your heading count against top-ranking pages for your keyword to give you a data-informed target.

Does the Heading Analyzer check HTML or visual headings?

It checks HTML heading tags (h1-h6). Text that visually looks like a heading but uses div or span tags with CSS styling is not recognized by search engines as headings. The skill flags these so you can convert them to proper heading tags.

Related skills

Content SEO

Content Readability Scorer

/readability

Score your content's readability using Flesch-Kincaid, sentence length analysis, and paragraph structure checks. Get specific suggestions to improve scannability.

Content SEO

Content Brief Generator

/content-brief

Generate data-driven content briefs with target keywords, heading structures, competitor analysis, and word count recommendations. Ready to hand to a writer.

Technical SEO

Site Audit

/seo-audit

Run a full technical SEO audit from your terminal. Checks crawlability, indexation issues, meta tags, page speed signals, and site structure in one pass.

Content SEO

Meta Tag Optimizer

/meta-optimize

Rewrite title tags and meta descriptions for better CTR and keyword targeting. Analyzes current tags against SERP competitors and suggests improvements.

Get all 50 skills

The SEO Command Center includes every skill in this library plus Python data fetchers, CLAUDE.md configs, and report templates. One-time purchase.

Browse all skills