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
-
Target keyword(s) clearly specified by user
-
Page content accessible (either via URL or provided HTML)
-
If competitor comparison requested, competitor URL provided
Output Validation
-
Every recommendation cites specific data points (not generic advice)
-
Scores based on measurable criteria, not subjective opinion
-
All suggested changes include specific locations (title tag, H2 #3, paragraph 5, etc.)
-
Source of each data point clearly stated (~~SEO tool data, user-provided, ~~web crawler, or manual review)
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
-
seo-content-writer — Create optimized content
-
technical-seo-checker — Technical SEO audit
-
meta-tags-optimizer — Optimize meta tags
-
serp-analysis — SERP context for audit findings
-
content-refresher — Update existing content
-
content-quality-auditor — Full 80-item CORE-EEAT audit
-
internal-linking-optimizer — Optimize internal link structure
-
schema-markup-generator — Validate and generate schema markup