Heading Tree

Heading Tree Skill

Purpose

Outputs H1-H4 heading hierarchy for a page. Structure only, no body copy.

Skill Output

Single deterministic heading tree. No alternatives, no variants.

headings:
  - level: h1
    section: hero
    text: "House Removals Bristol - Stress-Free Moving"
  - level: h2
    section: benefits
    text: "Why Families Choose Our Moving Service"
    children:
      - level: h3
        text: "Fully Insured & Protected"

Output contains text only. Patterns/examples are documentation only.

Input

page_type: landing | service | service-area | article
primary_keyword: "house removals bristol"  # Required
secondary_keywords: ["moving company"]      # Optional
location: "Bristol"                         # Required for local
sections: [hero, benefits, faq, final-cta]  # From allowed list
faq_questions: ["How much..."]              # Optional

Blocking Conditions (STOP)

Allowed Sections

Unknown section → ignored, no error.

Heading Rules

H1 Rules

H2 Rules

H3 Rules

H4 Rules

FAQ Questions

Generic FAQ templates:

• "How much does {service} cost?"
• "What areas do you cover?"
• "How do I book?"
• "Are you fully insured?"
• "How far in advance should I book?"
• "Do you provide {related_service}?"

Location Mentions

For local business pages:

Keyword Density (Annotation)

keyword_density: primary | secondary | location | none

This is annotation only — helps downstream skills, not a rule.

Example Output

page_type: landing
primary_keyword: "house removals bristol"

headings:
  - level: h1
    section: hero
    text: "House Removals Bristol - Stress-Free Moving From £299"
    
  - level: h2
    section: benefits
    text: "Why Families Choose Our Moving Service"
    children:
      - { level: h3, text: "Fully Insured & Protected" }
      - { level: h3, text: "Fixed Price, No Hidden Fees" }
      - { level: h3, text: "Professional Packing Service" }
      
  - level: h2
    section: faq
    text: "House Removals FAQs"
    children:
      - { level: h3, text: "How much do Bristol removals cost?" }
      - { level: h3, text: "What areas around Bristol do you cover?" }
      
  - level: h2
    section: final-cta
    text: "Ready for a Stress-Free Move?"

Non-goals

• Does NOT write body copy
• Does NOT suggest alternatives
• Does NOT optimize existing headings
• Does NOT do keyword research
• Does NOT analyze competitors

Forbidden

• ❌ Multiple H1s
• ❌ H4 on non-article pages
• ❌ Orphaned H3 (no parent H2)
• ❌ Keyword stuffing (>3 primary mentions)
• ❌ Providing alternative heading options
• ❌ Writing body content

References

• patterns-landing.md — Landing page patterns
• patterns-service.md — Service page patterns
• patterns-article.md — Article patterns

Definition of Done

• Exactly 1 H1
• H2s match sections list
• H3s have parent H2
• No H4 (unless article)
• Primary keyword in H1
• Primary keyword in 1-2 H2s
• Location in H1 + 2-3 H2s (if local)