# SEO Audit

> Skill: SEO Audit (Cross-Cutting)

- Skill: `polyxgo/seo-audit` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add polyxgo/seo-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/polyxgo/seo-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: PolyXGO (https://skillmd.com/u/polyxgo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/polyxgo/seo-audit

---

# Skill: SEO Audit (Cross-Cutting)

## Purpose

Run a comprehensive SEO audit — keyword research, on-page analysis, content gaps, technical checks, and competitor comparison to generate a prioritized SEO action plan.

## When to Use

- When assessing a website's overall SEO health and indexation status.
- When researching keyword opportunities and identifying high-volume, low-difficulty search queries.
- When identifying content gaps where competitors rank higher.
- When reviewing technical website issues (crawlability, page speed, structured schema data).

## Step-by-Step Process

### Step 1: Keyword & Competitor Research
- Extract primary and secondary keywords relevant to the business/domain.
- Group keywords by search intent (informational, navigational, commercial, transactional).
- Identify top 2-3 organic competitors.

### Step 2: On-Page SEO Analysis
- Verify title tag length (50-60 chars) and meta description length (150-160 chars).
- Confirm presence of exactly one H1 tag per page.
- Evaluate subheading hierarchy (H2/H3) and keyword usage.
- Assess image alt text and URL clean structure.

### Step 3: Content Gap & Freshness Review
- Detect topics covered by competitors but missing on the site.
- Identify pages with thin content (<300 words) or content older than 12 months.

### Step 4: Technical SEO Audit
- Review Robots.txt and XML sitemap configurations.
- Check canonical tags, HTTPS mixed content, and 404 broken links.
- Review Page Speed and Core Web Vitals (LCP, INP, CLS) markers.

### Step 5: Prioritized Action Plan Formulation
- Group recommendations into "Quick Wins" (<2h effort, high impact) and "Strategic Investments" (long-term, pillar pages).

## Required Input

- **Domain/URL**: The website to audit.
- **Audit Type**: Full site audit, keyword research, content gap, or technical SEO check.
- **Target Keywords** (Optional): Specific terms already being targeted.
- **Competitors** (Optional): Specific competitor URLs/domains.

## Expected Output

- **Executive Summary**: 3-5 sentence overview of SEO health and top 3 priorities.
- **Keyword Table**: Formatted table with Estimated Difficulty, Opportunity Score, and Intent.
- **On-Page Issues Table**: Issues categorized by Severity (Critical, High, Medium, Low).
- **Technical SEO Checklist**: Status (Pass, Fail, Warning) of crawlability, speed, and schema.
- **Prioritized Action Plan**: Split into Quick Wins and Strategic Investments.

## Tone & Rules

- Write in a professional, marketing-focused, data-driven tone.
- Do not make generic claims; base recommendations on specific, quantifiable SEO principles.
- Use bullet points and markdown tables for maximum scannability.

## Available Templates

- None

## Available Scripts

- None

## Examples

See `examples/` directory.

## Links to Other Skills

- **documents**: Use to draft the final SEO audit report or content briefs.
- **ui-ux**: Use to optimize pages for Core Web Vitals and mobile responsiveness.