On Page Seo Auditor

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...

Security Scan

This instruction-only on-page SEO auditor is internally consistent: it asks for page URLs or HTML and optionally integrates with SEO tools, but it does not request unrelated credentials, binaries, or installs.

Purpose & Capability

The skill's name/description (on-page SEO audit) aligns with its instructions and templates. It only requires page URL or HTML and optionally connects to SEO/crawl tools — all appropriate for its stated purpose.

Instruction Scope

SKILL.md confines actions to on-page checks (title, meta, headers, content, links, images, basic technical tags). It asks the user for URL/HTML and target keywords; it does not instruct reading unrelated system files or environment variables. It does allow using WebFetch or optional connectors to fetch pages and external SEO data, which is expected for this skill.

Install Mechanism

There is no install spec and no code files — this is instruction-only, so nothing is written to disk and no external packages are installed.

Credentials

The skill declares no required environment variables, credentials, or config paths. It mentions optional connectors/search-console integrations but does not require or request tokens itself; any credentials would be supplied by the user to the connector and are proportional to optional functionality.

Persistence & Privilege

always:false and no special privileges requested. The skill does not request persistent system presence or modify other skills' configurations.

Assessment

This skill appears to do what it says and is low-risk as-is because it's instruction-only and requests no credentials. Before installing or using it, note: (1) if you allow the agent to fetch pages, do not provide private/internal URLs containing sensitive data; (2) optional integrations (Search Console, SEO tools) would require you to grant credentials to those connectors — only grant least-privilege access and review connector endpoints; (3) because the skill can fetch external pages, avoid giving it access to systems you wouldn't want contacted. If you need automated live data, verify which connector implementations will be used and how credentials are stored/managed.

SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

<details> <summary>Browse all 20 skills</summary>

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

</details>

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

1. Title Tag Analysis: Evaluates title optimization and CTR potential
2. Meta Description Review: Checks description quality and length
3. Header Structure Audit: Analyzes H1-H6 hierarchy
4. Content Quality Assessment: Reviews content depth and optimization
5. Keyword Usage Analysis: Checks keyword placement and density
6. Internal Link Review: Evaluates internal linking structure
7. Image Optimization Check: Audits alt text and file optimization
8. 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:

1. Page URL or complete HTML content
2. Target primary and secondary keywords
3. 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:

1. 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]
   

2. 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]
   

3. 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)
   

4. 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]
   

5. 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).

6. 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).

7. 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).

8. Audit Images — Alt text, file names, sizes, formats, lazy loading

   Reference: See references/audit-templates.md for the image optimization template (Step 8).

9. 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).

10. 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.

11. 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

1. Prioritize issues by impact - Fix critical issues first
2. Compare to competitors - See what's working for top rankings
3. Balance optimization and readability - Don't over-optimize
4. Audit regularly - Content degrades over time
5. 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