Getting Started

Step-by-step guide to running your first SEO audit with SEO CodeBase Auditor.

Prerequisites

A static codebase (HTML, Markdown, Astro, Hugo, 11ty, Next.js, etc.)
An AI coding assistant (Cursor, Copilot, Claude, ChatGPT, or any LLM that supports file context)
SKILL.md downloaded into your project root

Installation

1. Clone or download the skill file:

git clone https://github.com/f9xr/seo-audit-report-skill.git
cp seo-audit-report-skill/SKILL.md /path/to/your/project/

Or simply download SKILL.md and place it in your project root.

2. Verify placement — SKILL.md should sit alongside your index.html, package.json, or equivalent entry point:

your-project/
├── SKILL.md          ← here
├── index.html
├── about.html
├── blog/
│   └── post-1.html
└── assets/
    └── styles.css

Running Your First Audit

Full Audit (Recommended)

In your AI tool, type:

@SKILL.md Run a comprehensive full-stack SEO audit across all files in this workspace. Generate seo_audit_report.md and seo_audit_report.csv with all applicable pillars evaluated.

Targeted Audit

Focus on specific areas:

@SKILL.md Run a Core Web Vitals audit across LCP, FCP, CLS, INP, and TTFB. Split findings by mobile vs desktop.

@SKILL.md Run an E-E-A-T deep audit. Evaluate trust page existence, author attribution, and YMYL compliance.

@SKILL.md Run a competitive SEO gap analysis against [competitor1.com, competitor2.com].

See Prompt Templates for all 22 templates.

What You Get

After running the audit, two files appear in your project root:

`seo_audit_report.md`

The full audit report containing:

Executive Summary — Site health overview in 3 sentences
Priority Fix Matrix — Top 20 issues sorted by severity and impact
Quick Wins — Fixes you can implement in under 30 minutes
Medium-Term Improvements — 1-4 week sprint items
Long-Term Strategic Initiatives — 1-3 month foundational work
Revenue & Traffic Opportunities — Highest-impact growth levers
Granular Pillar Evaluations — Per-pillar findings with exact fix blocks
CSV Export Reference — Spreadsheet companion note

`seo_audit_report.csv`

Column	Description
#	Priority rank
Pillar	Which of the 24 pillars
Issue	Detected problem
Severity	Critical / High / Medium / Low
File(s)	Target file path(s)
Effort	S (<4hr) / M (1-3d) / L (1-2wk) / XL (2+wk)
Traffic Impact	Estimated organic traffic change
Revenue Impact	Estimated revenue effect
Time to Impact	How quickly results appear
Business Value	Traffic / Revenue / Brand / Risk / Compliance

How the Audit Works

The skill operates in 5 distinct passes:

Pass 1 — Workspace Discovery

Maps the entire file tree, identifies project type (portfolio, e-commerce, SaaS, blog), discovers all URLs, builds an indexability matrix, and traces link graphs.

Pass 2 — Pillar Analysis

Evaluates every file against the 24 audit pillars. Irrelevant pillars are suppressed (e.g., no E-Commerce checks for a portfolio site).

Pass 3 — Prioritization

Sorts findings by severity, then by estimated traffic impact. Consolidates duplicate issues. Caps the Priority Fix Matrix at 20 items.

Pass 4 — Report Writing

Generates seo_audit_report.md with Evidence / Impact / Fix three-part finding format. Every fix block is production-ready code.

Pass 5 — Self-Critique

Reviews every finding against peer-review standards. Drops false positives. Verifies severity labels. Ensures every fix is deployable.

Supported Project Types

Project Type	Tailored Checks
Portfolio / Personal Site	Author schema, E-E-A-T, social cards, image SEO
E-Commerce	Product schema, review schema, faceted nav, category SEO
SaaS Landing Page	CTA optimization, conversion paths, structured data
Blog / Content Site	Article schema, content depth, freshness, reading time
Local Business	LocalBusiness schema, NAP consistency, GBP signals
Static Site Generator	Framework-specific checks (Astro, Hugo, 11ty, Next.js)
SPA / Client-Rendered	JS rendering, CSR detection, hydration audit

Supported AI Tools

Tool	How to Reference
Cursor	`@SKILL.md run a full audit`
GitHub Copilot	Attach `SKILL.md` to chat, then prompt
Claude	Paste prompt with `SKILL.md` context
ChatGPT	Upload `SKILL.md` as file context
Windsurf / Codeium	Reference `SKILL.md` in chat
Any LLM	Provide `SKILL.md` content in context window

Tips

Start with a full audit — Let the skill identify which pillars are relevant before running targeted checks.
Fix Quick Wins first — These are low-effort, high-impact items that can be deployed immediately.
Run audits regularly — SEO drift is real. Schedule monthly or pre-deployment audits.
Use the CSV — Import into Google Sheets or Excel for team tracking and sprint planning.
Reference Google's docs — Every finding links to the relevant Google guideline for verification.

Next Steps

All 24 Audit Pillars — Understand what each pillar checks
Prompt Templates — 22 templates for targeted audits
Output Format — Report structure and finding format