heading-tree

Generate deterministic SEO-friendly H1-H4 heading hierarchies from page configs.

4|1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/Soborbo/claudeskills --skill heading-tree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heading-tree
Source: https://github.com/Soborbo/claudeskills/tree/main/heading-tree
Command: npx skills add https://github.com/Soborbo/claudeskills --skill heading-tree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates a deterministic, SEO-friendly heading hierarchy (H1-H4) for a page, ensuring a clean, accessible structure without writing body content.

Core Features & Use Cases

  • Deterministic generation of H1-H4 heading structures for pages.
  • SEO-friendly and accessible hierarchy with proper parent-child relationships.
  • Suitable for landing, service, service-area, and article pages; supports local mentions in H2s where applicable.

Quick Start

Provide a config containing page_type, primary_keyword, location (if local), and sections, then run the skill to obtain a structured headings tree.

Frequently Asked Questions about heading-tree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an SEO-friendly heading hierarchy for a webpage?

To generate an SEO-friendly heading hierarchy, provide a configuration with page type, primary keyword, and sections. The system outputs a deterministic H1-H4 structure with exactly one H1 and properly nested H2-H4 tags.

What is the correct heading structure for a landing page or article?

The correct heading structure requires exactly one H1, section-aligned H2s, and properly nested H3 and H4 tags. This deterministic hierarchy ensures accessibility and SEO compliance without generating body content.

How do I create a heading tree with local SEO keywords for service-area pages?

To create a heading tree with local keywords, include the location in your configuration. The system generates H2s that incorporate local mentions, ensuring the hierarchy remains SEO-friendly and accessible for service-area pages.

Can I use this to enforce strict H1-H4 parent-child relationships without writing body content?

Yes, you can enforce strict H1-H4 parent-child relationships without writing body content. The system generates only the structural headings tree, ensuring proper nesting and adherence to allowed sections.

What configuration do I need to start building a deterministic headings tree?

You need a configuration containing page_type, primary_keyword, location if applicable, and sections. Running the skill with this input outputs a structured headings tree adhering to strict hierarchy constraints.

When should I use a deterministic heading structure generator instead of manual tagging?

Use a deterministic heading structure generator when you need strict SEO and accessibility compliance across multiple pages. It guarantees exactly one H1 and proper H3/H4 nesting for landing, service, and article pages, avoiding manual hierarchy errors.