On-Page SEO Auditor
SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills
Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis
Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator
Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher
Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager
Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management
This skill performs detailed on-page SEO audits to identify issues and optimization opportunities. It analyzes all on-page elements that affect search rankings and provides actionable recommendations.
When to Use This Skill
- Auditing pages before or after publishing
- Identifying why a page isn't ranking well
- Optimizing existing content for better performance
- Creating pre-publish SEO checklists
- Comparing your on-page SEO to competitors
- Systematic site-wide SEO improvements
- Training team members on SEO best practices
What This Skill Does
- Title Tag Analysis: Evaluates title optimization and CTR potential
- Meta Description Review: Checks description quality and length
- Header Structure Audit: Analyzes H1-H6 hierarchy
- Content Quality Assessment: Reviews content depth and optimization
- Keyword Usage Analysis: Checks keyword placement and density
- Internal Link Review: Evaluates internal linking structure
- Image Optimization Check: Audits alt text and file optimization
- Technical On-Page Review: Checks URL, canonical, and mobile factors
How to Use
Audit a Single Page
Audit the on-page SEO of [URL]
Check SEO issues on this page targeting [keyword]: [URL/content]
Compare Against Competitors
Compare on-page SEO of [your URL] vs [competitor URL] for [keyword]
Audit Content Before Publishing
Pre-publish SEO audit for this content targeting [keyword]: [content]
Data Sources
See CONNECTORS.md for tool category placeholders.
With ~~SEO tool + ~~web crawler connected:
Claude can automatically pull page HTML via ~~web crawler, fetch keyword search volume and difficulty from ~~SEO tool, retrieve click-through rate data from ~~search console, and download competitor pages for comparison. This enables fully automated audits with live data.
With manual data only:
Ask the user to provide:
- Page URL or complete HTML content
- Target primary and secondary keywords
- Competitor page URLs for comparison (optional)
Proceed with the full audit using provided data. Note in the output which findings are from automated crawl vs. manual review.
Instructions
When a user requests an on-page SEO audit:
Gather Page Information
### Audit Setup
**Page URL**: [URL]
**Target Keyword**: [primary keyword]
**Secondary Keywords**: [additional keywords]
**Page Type**: [blog/product/landing/service]
**Business Goal**: [traffic/conversions/authority]
Audit Title Tag
## Title Tag Analysis
**Current Title**: [title]
**Character Count**: [X] characters
| Criterion | Status | Notes |
|-----------|--------|-------|
| Length (50-60 chars) | ✅/⚠️/❌ | [notes] |
| Keyword included | ✅/⚠️/❌ | Position: [front/middle/end] |
| Keyword at front | ✅/⚠️/❌ | [notes] |
| Unique across site | ✅/⚠️/❌ | [notes] |
| Compelling/clickable | ✅/⚠️/❌ | [notes] |
| Matches intent | ✅/⚠️/❌ | [notes] |
**Title Score**: [X]/10
**Issues Found**:
- [Issue 1]
- [Issue 2]
**Recommended Title**:
"[Optimized title suggestion]"
**Why**: [Explanation of improvements]
Audit Meta Description
## Meta Description Analysis
**Current Description**: [description]
**Character Count**: [X] characters
| Criterion | Status | Notes |
|-----------|--------|-------|
| Length (150-160 chars) | ✅/⚠️/❌ | [notes] |
| Keyword included | ✅/⚠️/❌ | [notes] |
| Call-to-action present | ✅/⚠️/❌ | [notes] |
| Unique across site | ✅/⚠️/❌ | [notes] |
| Accurately describes page | ✅/⚠️/❌ | [notes] |
| Compelling copy | ✅/⚠️/❌ | [notes] |
**Description Score**: [X]/10
**Issues Found**:
- [Issue 1]
**Recommended Description**:
"[Optimized description suggestion]" ([X] chars)
Audit Header Structure
## Header Structure Analysis
### Current Header Hierarchy
H1: [H1 text]
H2: [H2 text]
H3: [H3 text]
H3: [H3 text]
H2: [H2 text]
H3: [H3 text]
H2: [H2 text]
| Criterion | Status | Notes |
|-----------|--------|-------|
| Single H1 | ✅/⚠️/❌ | Found: [X] H1s |
| H1 includes keyword | ✅/⚠️/❌ | [notes] |
| Logical hierarchy | ✅/⚠️/❌ | [notes] |
| H2s include keywords | ✅/⚠️/❌ | [X]/[Y] contain keywords |
| No skipped levels | ✅/⚠️/❌ | [notes] |
| Descriptive headers | ✅/⚠️/❌ | [notes] |
**Header Score**: [X]/10
**Issues Found**:
- [Issue 1]
- [Issue 2]
**Recommended Changes**:
- H1: [suggestion]
- H2s: [suggestions]
Audit Content Quality — Word count, reading level, comprehensiveness, formatting, E-E-A-T signals, content elements checklist, gap identification
Reference: See references/audit-templates.md for the content quality template (Step 5).
Audit Keyword Usage — Primary/secondary keyword placement across all page elements, LSI/related terms, density analysis
Reference: See references/audit-templates.md for the keyword optimization template (Step 6).
Audit Internal Links — Link count, anchor text relevance, broken links, recommended additions
Reference: See references/audit-templates.md for the internal linking template (Step 7).
Audit Images — Alt text, file names, sizes, formats, lazy loading
Reference: See references/audit-templates.md for the image optimization template (Step 8).
Audit Technical On-Page Elements — URL, canonical, mobile, speed, HTTPS, schema
Reference: See references/audit-templates.md for the technical on-page template (Step 9).
CORE-EEAT Content Quality Quick Scan — 17 on-page-relevant items from the 80-item CORE-EEAT benchmark
Reference: See references/audit-templates.md for the CORE-EEAT quick scan template (Step 10). Full benchmark: CORE-EEAT Benchmark.
Generate Audit Summary — Overall score with visual breakdown, priority issues (critical/important/minor), quick wins, detailed recommendations, competitor comparison, action checklist, expected results
Reference: See references/audit-templates.md for the full audit summary template (Step 11).
Validation Checkpoints
Input Validation
Output Validation
Example
Reference: See references/audit-example.md for a full worked example (noise-cancelling headphones audit) and page-type checklists (blog post, product page, landing page).
Tips for Success
- Prioritize issues by impact - Fix critical issues first
- Compare to competitors - See what's working for top rankings
- Balance optimization and readability - Don't over-optimize
- Audit regularly - Content degrades over time
- Test changes - Track ranking changes after updates
Scoring details: For the complete weight distribution, scoring scale, issue resolution playbook, and industry benchmarks, see references/scoring-rubric.md.
Reference Materials
- Scoring Rubric — Detailed scoring criteria, weight distribution, and grade boundaries for on-page audits
- Audit Templates — Detailed output templates for steps 5-11 (content quality, keywords, links, images, technical, CORE-EEAT scan, audit summary)
- Audit Example & Checklists — Full worked example and page-type checklists (blog, product, landing page)
Related Skills
1---2name: on-page-seo-auditor-33description: This skill should be used when the user asks to "audit page SEO", "on-page SEO check", "SEO score", "page optimization", "what SEO issues does this page have", "what is wrong with this page SEO", "score my page", or "why is this page not ranking". Performs comprehensive on-page SEO audits to identify optimization opportunities including title tags, meta descriptions, headers, content quality, internal linking, and image optimization. For server, speed, and crawl issues, see technical-seo-checker. For full EEAT content quality scoring, see content-quality-auditor.4license: Apache-2.05---6
7# On-Page SEO Auditor
8
9
10> **[SEO & GEO Skills Library](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · Install all: `npx skills add aaron-he-zhu/seo-geo-claude-skills`
11
12<details>
13<summary>Browse all 20 skills</summary>
14
15**Research** · [keyword-research](../../research/keyword-research/) · [competitor-analysis](../../research/competitor-analysis/) · [serp-analysis](../../research/serp-analysis/) · [content-gap-analysis](../../research/content-gap-analysis/)
16
17**Build** · [seo-content-writer](../../build/seo-content-writer/) · [geo-content-optimizer](../../build/geo-content-optimizer/) · [meta-tags-optimizer](../../build/meta-tags-optimizer/) · [schema-markup-generator](../../build/schema-markup-generator/)
18
19**Optimize** · **on-page-seo-auditor** · [technical-seo-checker](../technical-seo-checker/) · [internal-linking-optimizer](../internal-linking-optimizer/) · [content-refresher](../content-refresher/)
20
21**Monitor** · [rank-tracker](../../monitor/rank-tracker/) · [backlink-analyzer](../../monitor/backlink-analyzer/) · [performance-reporter](../../monitor/performance-reporter/) · [alert-manager](../../monitor/alert-manager/)
22
23**Cross-cutting** · [content-quality-auditor](../../cross-cutting/content-quality-auditor/) · [domain-authority-auditor](../../cross-cutting/domain-authority-auditor/) · [entity-optimizer](../../cross-cutting/entity-optimizer/) · [memory-management](../../cross-cutting/memory-management/)
24
25</details>
26
27This skill performs detailed on-page SEO audits to identify issues and optimization opportunities. It analyzes all on-page elements that affect search rankings and provides actionable recommendations.
28
29## When to Use This Skill
30
31- Auditing pages before or after publishing
32- Identifying why a page isn't ranking well
33- Optimizing existing content for better performance
34- Creating pre-publish SEO checklists
35- Comparing your on-page SEO to competitors
36- Systematic site-wide SEO improvements
37- Training team members on SEO best practices
38
39## What This Skill Does
40
411. **Title Tag Analysis**: Evaluates title optimization and CTR potential
422. **Meta Description Review**: Checks description quality and length
433. **Header Structure Audit**: Analyzes H1-H6 hierarchy
444. **Content Quality Assessment**: Reviews content depth and optimization
455. **Keyword Usage Analysis**: Checks keyword placement and density
466. **Internal Link Review**: Evaluates internal linking structure
477. **Image Optimization Check**: Audits alt text and file optimization
488. **Technical On-Page Review**: Checks URL, canonical, and mobile factors
49
50## How to Use
51
52### Audit a Single Page
53
54```
55Audit the on-page SEO of [URL]
56```
57
58```
59Check SEO issues on this page targeting [keyword]: [URL/content]
60```
61
62### Compare Against Competitors
63
64```
65Compare on-page SEO of [your URL] vs [competitor URL] for [keyword]
66```
67
68### Audit Content Before Publishing
69
70```
71Pre-publish SEO audit for this content targeting [keyword]: [content]
72```
73
74## Data Sources
75
76> See [CONNECTORS.md](../../CONNECTORS.md) for tool category placeholders.
77
78**With ~~SEO tool + ~~web crawler connected:**
79Claude can automatically pull page HTML via ~~web crawler, fetch keyword search volume and difficulty from ~~SEO tool, retrieve click-through rate data from ~~search console, and download competitor pages for comparison. This enables fully automated audits with live data.
80
81**With manual data only:**
82Ask the user to provide:
831. Page URL or complete HTML content
842. Target primary and secondary keywords
853. Competitor page URLs for comparison (optional)
86
87Proceed with the full audit using provided data. Note in the output which findings are from automated crawl vs. manual review.
88
89## Instructions
90
91When a user requests an on-page SEO audit:
92
931. **Gather Page Information**
94
95 ```markdown
96 ### Audit Setup
97
98 **Page URL**: [URL]
99 **Target Keyword**: [primary keyword]
100 **Secondary Keywords**: [additional keywords]
101 **Page Type**: [blog/product/landing/service]
102 **Business Goal**: [traffic/conversions/authority]
103 ```
104
1052. **Audit Title Tag**
106
107 ```markdown
108 ## Title Tag Analysis
109
110 **Current Title**: [title]
111 **Character Count**: [X] characters
112
113 | Criterion | Status | Notes |
114 |-----------|--------|-------|
115 | Length (50-60 chars) | ✅/⚠️/❌ | [notes] |
116 | Keyword included | ✅/⚠️/❌ | Position: [front/middle/end] |
117 | Keyword at front | ✅/⚠️/❌ | [notes] |
118 | Unique across site | ✅/⚠️/❌ | [notes] |
119 | Compelling/clickable | ✅/⚠️/❌ | [notes] |
120 | Matches intent | ✅/⚠️/❌ | [notes] |
121
122 **Title Score**: [X]/10
123
124 **Issues Found**:
125 - [Issue 1]
126 - [Issue 2]
127
128 **Recommended Title**:
129 "[Optimized title suggestion]"
130
131 **Why**: [Explanation of improvements]
132 ```
133
1343. **Audit Meta Description**
135
136 ```markdown
137 ## Meta Description Analysis
138
139 **Current Description**: [description]
140 **Character Count**: [X] characters
141
142 | Criterion | Status | Notes |
143 |-----------|--------|-------|
144 | Length (150-160 chars) | ✅/⚠️/❌ | [notes] |
145 | Keyword included | ✅/⚠️/❌ | [notes] |
146 | Call-to-action present | ✅/⚠️/❌ | [notes] |
147 | Unique across site | ✅/⚠️/❌ | [notes] |
148 | Accurately describes page | ✅/⚠️/❌ | [notes] |
149 | Compelling copy | ✅/⚠️/❌ | [notes] |
150
151 **Description Score**: [X]/10
152
153 **Issues Found**:
154 - [Issue 1]
155
156 **Recommended Description**:
157 "[Optimized description suggestion]" ([X] chars)
158 ```
159
1604. **Audit Header Structure**
161
162 ```markdown
163 ## Header Structure Analysis
164
165 ### Current Header Hierarchy
166
167 ```
168 H1: [H1 text]
169 H2: [H2 text]
170 H3: [H3 text]
171 H3: [H3 text]
172 H2: [H2 text]
173 H3: [H3 text]
174 H2: [H2 text]
175 ```
176
177 | Criterion | Status | Notes |
178 |-----------|--------|-------|
179 | Single H1 | ✅/⚠️/❌ | Found: [X] H1s |
180 | H1 includes keyword | ✅/⚠️/❌ | [notes] |
181 | Logical hierarchy | ✅/⚠️/❌ | [notes] |
182 | H2s include keywords | ✅/⚠️/❌ | [X]/[Y] contain keywords |
183 | No skipped levels | ✅/⚠️/❌ | [notes] |
184 | Descriptive headers | ✅/⚠️/❌ | [notes] |
185
186 **Header Score**: [X]/10
187
188 **Issues Found**:
189 - [Issue 1]
190 - [Issue 2]
191
192 **Recommended Changes**:
193 - H1: [suggestion]
194 - H2s: [suggestions]
195 ```
196
1975. **Audit Content Quality** — Word count, reading level, comprehensiveness, formatting, E-E-A-T signals, content elements checklist, gap identification
198
199 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the content quality template (Step 5).
200
2016. **Audit Keyword Usage** — Primary/secondary keyword placement across all page elements, LSI/related terms, density analysis
202
203 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the keyword optimization template (Step 6).
204
2057. **Audit Internal Links** — Link count, anchor text relevance, broken links, recommended additions
206
207 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the internal linking template (Step 7).
208
2098. **Audit Images** — Alt text, file names, sizes, formats, lazy loading
210
211 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the image optimization template (Step 8).
212
2139. **Audit Technical On-Page Elements** — URL, canonical, mobile, speed, HTTPS, schema
214
215 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the technical on-page template (Step 9).
216
21710. **CORE-EEAT Content Quality Quick Scan** — 17 on-page-relevant items from the 80-item CORE-EEAT benchmark
218
219 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the CORE-EEAT quick scan template (Step 10). Full benchmark: [CORE-EEAT Benchmark](../../references/core-eeat-benchmark.md).
220
22111. **Generate Audit Summary** — Overall score with visual breakdown, priority issues (critical/important/minor), quick wins, detailed recommendations, competitor comparison, action checklist, expected results
222
223 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the full audit summary template (Step 11).
224
225## Validation Checkpoints
226
227### Input Validation
228- [ ] Target keyword(s) clearly specified by user
229- [ ] Page content accessible (either via URL or provided HTML)
230- [ ] If competitor comparison requested, competitor URL provided
231
232### Output Validation
233- [ ] Every recommendation cites specific data points (not generic advice)
234- [ ] Scores based on measurable criteria, not subjective opinion
235- [ ] All suggested changes include specific locations (title tag, H2 #3, paragraph 5, etc.)
236- [ ] Source of each data point clearly stated (~~SEO tool data, user-provided, ~~web crawler, or manual review)
237
238## Example
239
240> **Reference**: See [references/audit-example.md](./references/audit-example.md) for a full worked example (noise-cancelling headphones audit) and page-type checklists (blog post, product page, landing page).
241
242## Tips for Success
243
2441. **Prioritize issues by impact** - Fix critical issues first
2452. **Compare to competitors** - See what's working for top rankings
2463. **Balance optimization and readability** - Don't over-optimize
2474. **Audit regularly** - Content degrades over time
2485. **Test changes** - Track ranking changes after updates
249
250> **Scoring details**: For the complete weight distribution, scoring scale, issue resolution playbook, and industry benchmarks, see [references/scoring-rubric.md](./references/scoring-rubric.md).
251
252## Reference Materials
253
254- [Scoring Rubric](./references/scoring-rubric.md) — Detailed scoring criteria, weight distribution, and grade boundaries for on-page audits
255- [Audit Templates](./references/audit-templates.md) — Detailed output templates for steps 5-11 (content quality, keywords, links, images, technical, CORE-EEAT scan, audit summary)
256- [Audit Example & Checklists](./references/audit-example.md) — Full worked example and page-type checklists (blog, product, landing page)
257
258## Related Skills
259
260- [seo-content-writer](../../build/seo-content-writer/) — Create optimized content
261- [technical-seo-checker](../technical-seo-checker/) — Technical SEO audit
262- [meta-tags-optimizer](../../build/meta-tags-optimizer/) — Optimize meta tags
263- [serp-analysis](../../research/serp-analysis/) — SERP context for audit findings
264- [content-refresher](../content-refresher/) — Update existing content
265- [content-quality-auditor](../../cross-cutting/content-quality-auditor/) — Full 80-item CORE-EEAT audit
266- [internal-linking-optimizer](../internal-linking-optimizer/) — Optimize internal link structure
267- [schema-markup-generator](../../build/schema-markup-generator/) — Validate and generate schema markup
268