heading-structurelisted
Install: claude install-skill gaznilmuzammil12-prog/seo-skills-by-gaznil
# 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 |
|-----------|-----------|
| **Logical order** | H1 -> H2 -> H3; don't skip levels |
| **One idea per heading** | Each heading = one topic |
| **Scannable** | Headings should summarize section content |
| **Keyword variation** | Use related keywords in subheadings |
### Structure
```
H1 (page title)