| name | on-page-seo-auditor |
| description | Performs comprehensive on-page SEO audits to identify optimization opportunities including title tags, meta descriptions, headers, content quality, internal linking, and image optimization. |
On-Page SEO Auditor
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]
Validation Checkpoints
Input Validation
Output Validation
Example
User: "Audit the on-page SEO of my blog post about 'email marketing tips'"
Output: [Comprehensive audit following the structure above with specific findings and recommendations]
Audit Checklists by Page Type
Blog Post Checklist
- [ ] Title includes keyword and is compelling
- [ ] Meta description has keyword and CTA
- [ ] Single H1 with keyword
- [ ] H2s cover main topics
- [ ] Keyword in first 100 words
- [ ] 1,500+ words for competitive topics
- [ ] 3+ internal links with varied anchors
- [ ] Images with descriptive alt text
- [ ] FAQ section with schema
- [ ] Author bio with credentials
Product Page Checklist
- [ ] Product name in title
- [ ] Price and availability in description
- [ ] H1 is product name
- [ ] Product features in H2s
- [ ] Multiple product images with alt text
- [ ] Customer reviews visible
- [ ] Product schema implemented
- [ ] Related products linked
- [ ] Clear CTA button
Landing Page Checklist
- [ ] Keyword-optimized title
- [ ] Benefit-focused meta description
- [ ] Clear H1 value proposition
- [ ] Supporting H2 sections
- [ ] Trust signals (testimonials, logos)
- [ ] Single clear CTA
- [ ] Fast page load speed
- [ ] Mobile-optimized layout
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
Related Skills
