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-auditor3description: 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.4---56# On-Page SEO Auditor789> **[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`1011<details>12<summary>Browse all 20 skills</summary>1314**Research** · [keyword-research](../../research/keyword-research/) · [competitor-analysis](../../research/competitor-analysis/) · [serp-analysis](../../research/serp-analysis/) · [content-gap-analysis](../../research/content-gap-analysis/)1516**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/)1718**Optimize** · **on-page-seo-auditor** · [technical-seo-checker](../technical-seo-checker/) · [internal-linking-optimizer](../internal-linking-optimizer/) · [content-refresher](../content-refresher/)1920**Monitor** · [rank-tracker](../../monitor/rank-tracker/) · [backlink-analyzer](../../monitor/backlink-analyzer/) · [performance-reporter](../../monitor/performance-reporter/) · [alert-manager](../../monitor/alert-manager/)2122**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/)2324</details>2526This 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.2728## When to Use This Skill2930- Auditing pages before or after publishing31- Identifying why a page isn't ranking well32- Optimizing existing content for better performance33- Creating pre-publish SEO checklists34- Comparing your on-page SEO to competitors35- Systematic site-wide SEO improvements36- Training team members on SEO best practices3738## What This Skill Does39401. **Title Tag Analysis**: Evaluates title optimization and CTR potential412. **Meta Description Review**: Checks description quality and length423. **Header Structure Audit**: Analyzes H1-H6 hierarchy434. **Content Quality Assessment**: Reviews content depth and optimization445. **Keyword Usage Analysis**: Checks keyword placement and density456. **Internal Link Review**: Evaluates internal linking structure467. **Image Optimization Check**: Audits alt text and file optimization478. **Technical On-Page Review**: Checks URL, canonical, and mobile factors4849## How to Use5051### Audit a Single Page5253```54Audit the on-page SEO of [URL]55```5657```58Check SEO issues on this page targeting [keyword]: [URL/content]59```6061### Compare Against Competitors6263```64Compare on-page SEO of [your URL] vs [competitor URL] for [keyword]65```6667### Audit Content Before Publishing6869```70Pre-publish SEO audit for this content targeting [keyword]: [content]71```7273## Data Sources7475> See [CONNECTORS.md](../../CONNECTORS.md) for tool category placeholders.7677**With ~~SEO tool + ~~web crawler connected:**78Claude 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.7980**With manual data only:**81Ask the user to provide:821. Page URL or complete HTML content832. Target primary and secondary keywords843. Competitor page URLs for comparison (optional)8586Proceed with the full audit using provided data. Note in the output which findings are from automated crawl vs. manual review.8788## Instructions8990When a user requests an on-page SEO audit:91921. **Gather Page Information**9394 ```markdown95 ### Audit Setup96 97 **Page URL**: [URL]98 **Target Keyword**: [primary keyword]99 **Secondary Keywords**: [additional keywords]100 **Page Type**: [blog/product/landing/service]101 **Business Goal**: [traffic/conversions/authority]102 ```1031042. **Audit Title Tag**105106 ```markdown107 ## Title Tag Analysis108 109 **Current Title**: [title]110 **Character Count**: [X] characters111 112 | Criterion | Status | Notes |113 |-----------|--------|-------|114 | Length (50-60 chars) | ✅/⚠️/❌ | [notes] |115 | Keyword included | ✅/⚠️/❌ | Position: [front/middle/end] |116 | Keyword at front | ✅/⚠️/❌ | [notes] |117 | Unique across site | ✅/⚠️/❌ | [notes] |118 | Compelling/clickable | ✅/⚠️/❌ | [notes] |119 | Matches intent | ✅/⚠️/❌ | [notes] |120 121 **Title Score**: [X]/10122 123 **Issues Found**:124 - [Issue 1]125 - [Issue 2]126 127 **Recommended Title**:128 "[Optimized title suggestion]"129 130 **Why**: [Explanation of improvements]131 ```1321333. **Audit Meta Description**134135 ```markdown136 ## Meta Description Analysis137 138 **Current Description**: [description]139 **Character Count**: [X] characters140 141 | Criterion | Status | Notes |142 |-----------|--------|-------|143 | Length (150-160 chars) | ✅/⚠️/❌ | [notes] |144 | Keyword included | ✅/⚠️/❌ | [notes] |145 | Call-to-action present | ✅/⚠️/❌ | [notes] |146 | Unique across site | ✅/⚠️/❌ | [notes] |147 | Accurately describes page | ✅/⚠️/❌ | [notes] |148 | Compelling copy | ✅/⚠️/❌ | [notes] |149 150 **Description Score**: [X]/10151 152 **Issues Found**:153 - [Issue 1]154 155 **Recommended Description**:156 "[Optimized description suggestion]" ([X] chars)157 ```1581594. **Audit Header Structure**160161 ```markdown162 ## Header Structure Analysis163 164 ### Current Header Hierarchy165 166 ```167 H1: [H1 text]168 H2: [H2 text]169 H3: [H3 text]170 H3: [H3 text]171 H2: [H2 text]172 H3: [H3 text]173 H2: [H2 text]174 ```175 176 | Criterion | Status | Notes |177 |-----------|--------|-------|178 | Single H1 | ✅/⚠️/❌ | Found: [X] H1s |179 | H1 includes keyword | ✅/⚠️/❌ | [notes] |180 | Logical hierarchy | ✅/⚠️/❌ | [notes] |181 | H2s include keywords | ✅/⚠️/❌ | [X]/[Y] contain keywords |182 | No skipped levels | ✅/⚠️/❌ | [notes] |183 | Descriptive headers | ✅/⚠️/❌ | [notes] |184 185 **Header Score**: [X]/10186 187 **Issues Found**:188 - [Issue 1]189 - [Issue 2]190 191 **Recommended Changes**:192 - H1: [suggestion]193 - H2s: [suggestions]194 ```1951965. **Audit Content Quality** — Word count, reading level, comprehensiveness, formatting, E-E-A-T signals, content elements checklist, gap identification197198 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the content quality template (Step 5).1992006. **Audit Keyword Usage** — Primary/secondary keyword placement across all page elements, LSI/related terms, density analysis201202 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the keyword optimization template (Step 6).2032047. **Audit Internal Links** — Link count, anchor text relevance, broken links, recommended additions205206 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the internal linking template (Step 7).2072088. **Audit Images** — Alt text, file names, sizes, formats, lazy loading209210 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the image optimization template (Step 8).2112129. **Audit Technical On-Page Elements** — URL, canonical, mobile, speed, HTTPS, schema213214 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the technical on-page template (Step 9).21521610. **CORE-EEAT Content Quality Quick Scan** — 17 on-page-relevant items from the 80-item CORE-EEAT benchmark217218 > **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).21922011. **Generate Audit Summary** — Overall score with visual breakdown, priority issues (critical/important/minor), quick wins, detailed recommendations, competitor comparison, action checklist, expected results221222 > **Reference**: See [references/audit-templates.md](./references/audit-templates.md) for the full audit summary template (Step 11).223224## Validation Checkpoints225226### Input Validation227- [ ] Target keyword(s) clearly specified by user228- [ ] Page content accessible (either via URL or provided HTML)229- [ ] If competitor comparison requested, competitor URL provided230231### Output Validation232- [ ] Every recommendation cites specific data points (not generic advice)233- [ ] Scores based on measurable criteria, not subjective opinion234- [ ] All suggested changes include specific locations (title tag, H2 #3, paragraph 5, etc.)235- [ ] Source of each data point clearly stated (~~SEO tool data, user-provided, ~~web crawler, or manual review)236237## Example238239> **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).240241## Tips for Success2422431. **Prioritize issues by impact** - Fix critical issues first2442. **Compare to competitors** - See what's working for top rankings2453. **Balance optimization and readability** - Don't over-optimize2464. **Audit regularly** - Content degrades over time2475. **Test changes** - Track ranking changes after updates248249> **Scoring details**: For the complete weight distribution, scoring scale, issue resolution playbook, and industry benchmarks, see [references/scoring-rubric.md](./references/scoring-rubric.md).250251## Reference Materials252253- [Scoring Rubric](./references/scoring-rubric.md) — Detailed scoring criteria, weight distribution, and grade boundaries for on-page audits254- [Audit Templates](./references/audit-templates.md) — Detailed output templates for steps 5-11 (content quality, keywords, links, images, technical, CORE-EEAT scan, audit summary)255- [Audit Example & Checklists](./references/audit-example.md) — Full worked example and page-type checklists (blog, product, landing page)256257## Related Skills258259- [seo-content-writer](../../build/seo-content-writer/) — Create optimized content260- [technical-seo-checker](../technical-seo-checker/) — Technical SEO audit261- [meta-tags-optimizer](../../build/meta-tags-optimizer/) — Optimize meta tags262- [serp-analysis](../../research/serp-analysis/) — SERP context for audit findings263- [content-refresher](../content-refresher/) — Update existing content264- [content-quality-auditor](../../cross-cutting/content-quality-auditor/) — Full 80-item CORE-EEAT audit265- [internal-linking-optimizer](../internal-linking-optimizer/) — Optimize internal link structure266- [schema-markup-generator](../../build/schema-markup-generator/) — Validate and generate schema markup267