Agent Skills
› kostja94/marketing-skills
› heading-structure
heading-structure
GitHub指导SEO页面标题结构优化，规范H1-H6层级逻辑，确保内容层次清晰、语义准确及与搜索意图一致，修复多重H1等常见问题。
Trigger Scenarios
优化或重写H1-H6标题
修复标题层级混乱
调整内容结构以匹配页面意图
Install
npx skills add kostja94/marketing-skills --skill heading-structure -g -y
SKILL.md
Frontmatter
{
"name": "heading-structure",
"metadata": {
"version": "2.0.0"
},
"description": "When the user wants to write or optimize H1-H6, fix heading hierarchy, improve content structure, rewrite an H1, or align headings with page intent. This skill owns actual heading changes; page-metadata may only check and report metadata-to-heading alignment."
}
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 contextus.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:
- Page type: Homepage, article, product, etc.
- Primary keyword: Target search query
- Content outline: Main sections and subsections
Best Practices
H1
| Principle | Guideline |
|---|---|
| Primary page heading | Prefer one clear H1 that identifies the page; audit accessibility and template semantics before treating an extra H1 as a ranking emergency |
| Search language | Include the primary concept naturally when useful; do not force exact-match phrasing |
| Descriptive | Clearly describe page content |
| Match intent | Serve the same page intent and promise as the title tag without requiring identical wording |
H2-H6 Hierarchy
| Principle | Guideline |
|---|---|
| Logical order | Use heading levels to express document structure; do not choose a level for visual size alone |
| 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)
-> H2 (section 1)
-> H3 (subsection)
-> H3
-> H2 (section 2)
-> H3
-> H2 (section 3)
Common Issues
| Issue | Fix |
|---|---|
| Multiple H1s | Confirm the template and accessibility semantics; prefer one clear primary H1, but do not present extra H1s as an automatic ranking failure |
| Visual styling encoded as hierarchy | Keep semantic level based on structure and style it separately |
| Generic headings | Make descriptive; avoid "Introduction," "Conclusion" |
| Keyword stuffing | Natural language; avoid forced keywords |
Output Format
- H1 recommendation (with keyword)
- H2-H6 outline for content
- Hierarchy check
- References: Google headings
Related Skills
- featured-snippet: H2/H3 for snippet extraction; semantic HTML for list/table snippets
- page-metadata: Checks and reports title/H1/body alignment; routes actual heading edits here
- content-optimization: H2 keyword placement, quantity, tables, lists; complements heading structure
- article-page-generator: Article page H1-H3 structure, intro/body/conclusion
- title-tag: H1 and title share page intent but may use different natural variants
- schema-markup: Article schema uses headline (often H1)
- content-strategy: Content outline informs headings
Version History
-
8dd89c5
Current 2026-10-19 01:31
细化了H1和子标题的最佳实践指南，增加了关于模板语义、可访问性及避免强制关键词匹配的说明。
-
26cef34
2026-09-27 18:59
重构项目上下文读取逻辑，将Contextus设为单一事实来源(SSOT)，替代旧的多文件检查方式。
- 70987ba 2026-07-06 00:09
