heading-optimizer

What problem does it solve?

This Skill helps you detect and fix weak, inconsistent, or structurally incorrect heading usage across AEM Edge Delivery Services (EDS) pages so your content aligns with search intent and remains accessible.

Core Features & Use Cases

• Headings inventory (H1–H6): Extracts all headings from EDS pages via .plain.html, including section and block context, so you can see the real outline authors created.
• SEO-focused evaluation: Flags issues like missing/duplicate H1s, generic headings (e.g., “Overview”), keyword mismatch, overly long/short H1s, and mismatched intent.
• Hierarchy & consistency checking: Detects skipped levels, empty headings, and cross-page duplication or naming inconsistencies, then recommends safer replacements.

Use Case: Standardize blog post and landing page heading patterns after noticing multiple pages share the same generic H1 (e.g., “Overview”) and several pages skip levels (H1 → H3), which harms both search clarity and accessibility.

Quick Start

Run the heading-optimizer on your target EDS pages by providing the page paths (or your query index) and ask it to return a heading audit with before/after optimized suggestions for each impacted page.