heading-structure

Name: heading-structure
Author: kostja94

When the user wants to optimize heading structure (H1-H6), fix heading hierarchy, or improve content structure. Also use when the user mentions "H1,"…

INSTALLATION

npx skills add https://github.com/kostja94/marketing-skills --skill heading-structure

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$27

Best Practices

H1

Principle

Guideline

One per page

Single H1 per page

Primary keyword

Include target keyword naturally

Descriptive

Clearly describe page content

Match intent

Align with title tag and user intent

H2-H6 Hierarchy

Principle

Guideline

Logical order

H1 -> H2 -> H3; don't skip levels

One idea per heading

Each heading = one topic

Scannable

Headings should summarize section content

Keyword variation

Use related keywords in subheadings

Structure

H1 (page title)

-> H2 (section 1)

   -> H3 (subsection)

   -> H3

-> H2 (section 2)

   -> H3

-> H2 (section 3)

Common Issues

Issue

Fix

Multiple H1s

Use single H1; use H2 for other sections

Skipped levels

Use H2 after H1, H3 after H2

Generic headings

Make descriptive; avoid "Introduction," "Conclusion"

Keyword stuffing

Natural language; avoid forced keywords

Output Format

H1 recommendation (with keyword)

H2-H6 outline for content

Hierarchy check

References: Google headings

Related Skills

featured-snippet: H2/H3 for snippet extraction; semantic HTML for list/table snippets

page-metadata: Hreflang, meta robots; metadata complements heading structure

content-optimization: H2 keyword placement, quantity, tables, lists; complements heading structure

article-page-generator: Article page H1-H3 structure, intro/body/conclusion

title-tag: H1 should align with title tag

schema-markup: Article schema uses headline (often H1)

content-strategy: Content outline informs headings