heading-structure
When the user wants to optimize heading structure (H1-H6), fix heading hierarchy, or improve content structure. Also use when the user mentions "H1," "heading," "heading hierarchy," "content structure," "H2," "H3," "heading tags," "heading SEO," "multiple H1," or "heading structure." For SEO workflow, use seo-strategy.
npx skills add kostja94/marketing-skills --skill heading --agent cursor
Same command for any agent — swap --agent for claude-code, codex, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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**: One per page; clear headline; matches content; primary keyword near start - **Header tags (H1-H6)**: Logical hierarchy; keyword in headers; one idea per heading ## Initial Assessment **Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for target keywords. Identify: 1. **Page type**: Homepage, article, product, etc. 2. **Primary keyword**: Target search query 3. **Content outline**: Main sections and subsections ## Best Practices ### H1 | Principle | Guideline | |-----------|-----------| | **One per page** | Single H1 per page | | **Primary keyword** | Include target keyword naturally | | **Descriptive** | Clearly describe page content | | **Match intent** | Align with title tag and user intent | ### H2-H6 Hierarchy | Principle | Guideline | |-----------|
- Scope (On-Page SEO)
- Initial Assessment
- Best Practices
- H1
- H2-H6 Hierarchy
- Structure
- Common Issues
- Output Format
- Related Skills
What does the heading-structure skill do?
When the user wants to optimize heading structure (H1-H6), fix heading hierarchy, or improve content structure. Also use when the user mentions "H1," "heading," "heading hierarchy," "content structure," "H2," "H3," "heading tags," "heading SEO," "multiple H1," or "heading structure." For SEO workflow, use seo-strategy.
How do I install it?
Run `npx skills add kostja94/marketing-skills --skill heading --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From kostja94/marketing-skills, a repository with 848 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.