Heading Structure

This handles H1 through H6 optimization when you're trying to fix heading hierarchy or structure content for SEO. It checks for project context first to grab target keywords, then walks you through single H1 per page, logical nesting without skipping levels, and keyword placement in subheadings. The output gives you an H1 recommendation plus a full H2 through H6 outline with hierarchy validation. Honestly most useful when you inherit a mess of multiple H1s or random heading levels, since it enforces the basic rules search engines expect. Connects well with title tag and content optimization skills if you're doing broader SEO work.

skills.sh installs: 1.1K
GitHub stars: 1.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add kostja94/marketing-skills --skill heading-structure --agent claude-code

Installs into .claude/skills of the current project.

Files

SEO On-Page: Heading Structure

Guides heading (H1-H6) optimization for SEO and content structure.

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.

Scope (On-Page SEO)

H1 tag: Clear visible page headline that confirms the user's task and value
Header tags (H1-H6): Logical content hierarchy and one coherent section per heading

Initial Assessment

Project context: Read root {project}.md when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify: