Heading Structure
- 801 installs
- 787 repo stars
- Updated June 9, 2026
- kostja94/marketing-skills
heading-structure is a marketing-skills on-page SEO skill (v1.0.1) that audits and optimizes H1–H6 heading hierarchies so search engines and readers can parse page structure and target keywords.
About
heading-structure is version 1.0.1 at skills/seo/on-page/heading in kostja94/marketing-skills. It guides H1–H6 optimization for SEO and content structure, enforcing one H1 per page with the primary keyword near the start and logical H2–H6 nesting without skipped levels. The skill diagnoses common issues like multiple H1 tags, skipped heading levels, and keyword-stuffed headings. Developers invoke it when users mention H1, heading hierarchy, heading tags, heading SEO, multiple H1, or content structure. It complements content-optimization for body copy and reads project-context.md for target keywords. Output includes corrected outline trees showing H1 → H2 → H3 relationships aligned with search intent.
- Enforces single H1 per page with primary keyword near the start
- Builds logical H1-H6 hierarchy with one idea per heading
- Reads project-context.md to extract target keywords and page type before analysis
- Applies on-page SEO rules that also improve readability and content outline clarity
- Triggers automatically on mentions of H1, heading hierarchy, H2-H3, or heading structure
Heading Structure by the numbers
- 801 all-time installs (skills.sh)
- +6 installs in the week ending Jul 27, 2026 (Skillselion tracking)
- Ranked #557 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kostja94/marketing-skills --skill heading-structureAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 801 |
|---|---|
| repo stars | ★ 787 |
| Security audit | 3 / 3 scanners passed |
| Last updated | June 9, 2026 |
| Repository | kostja94/marketing-skills ↗ |
How do you fix heading hierarchy for SEO?
Audit, fix, and optimize heading hierarchies so search engines and readers understand page structure instantly.
Who is it for?
Developers publishing articles, product pages, or landing pages who need H1–H6 hierarchy audits aligned with on-page SEO best practices.
Skip if: Skip heading-structure when the goal is accessibility-only document outline without SEO keyword alignment—consider inclusive-design heading skills instead.
When should I use this skill?
User mentions H1, heading hierarchy, heading structure, multiple H1, H2 keywords, or heading tag SEO issues.
What you get
Corrected H1–H6 outline tree, heading audit findings, and keyword-aligned heading recommendations per page section
- heading audit report
- corrected outline tree
- H1–H6 recommendations
By the numbers
- Skill version 1.0.1 in kostja94/marketing-skills
- Covers H1 through H6 heading tag optimization
Files
SEO: Local
Guides local SEO: Google Business Profile, NAP consistency, and citation building. Businesses with accurate NAP across 40+ authoritative sites see ~19% higher visibility in Google Maps. Use this skill when optimizing for local search, setting up GBP, or auditing citations.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read Sections 4 (Audience), 5 (Website).
Identify: 1. Business type: Storefront vs service-area 2. Location: Single or multiple 3. Current listings: Existing GBP, directories
NAP Consistency
NAP = Name, Address, Phone. Critical for local rankings.
| Rule | Guideline |
|---|---|
| Exact match | "Street" vs "St." or "LLC" inconsistency = Google may treat as different entities |
| Fix first | Audit and fix inconsistencies before adding new citations |
| Tools | BrightLocal, Whitespark, Moz Local for audit |
Google Business Profile
| Element | Guideline |
|---|---|
| Address | Physical address; no P.O. boxes |
| Description | 750 chars; primary keywords in first 100 |
| Hours | Accurate; seasonal availability |
| Category | Primary category matches business type |
| Service-area | Hide address if no storefront; define service areas |
Citation Building
Targeted precision over submitting to every directory.
Priority order: 1. Google Business Profile 2. Apple Maps 3. Yelp, Bing Places, Facebook 4. Better Business Bureau, Foursquare, Nextdoor 5. Niche directories (Healthgrades, Angi, etc.)
Citation Audit
- Incorrect or outdated data
- Duplicate entries
- Missing listings on key directories
Fix before adding; compounding errors harm rankings.
Output Format
- NAP (exact format for consistency)
- GBP optimization checklist
- Citation priority list
- Audit findings (if applicable)
Related Skills
- geo: GEO for AI search; local + AI overlap
- localization-strategy: Multilingual; local + i18n
- directory-submission: Directory listings; different from local citations
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.173k42.2kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.164k42.2k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k67Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k67Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k67Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k67How it compares
Use heading-structure for SEO hierarchy audits; use content-optimization when the focus is body copy length, density, and multimedia rather than heading trees.
FAQ
How many H1 tags does heading-structure allow per page?
heading-structure enforces exactly one H1 per page. The H1 should clearly describe page content, include the primary keyword naturally near the start, and align with the title tag and user search intent.
What heading order does heading-structure require?
heading-structure requires logical nesting from H1 through H2 and H3 without skipping levels. Each heading should cover one topic, use related keyword variations in subheadings, and remain scannable for readers.
Is Heading Structure safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.