seo-audit

name

seo-audit

description

Comprehensive SEO audit for static websites. Analyses 11 categories — technical SEO, on-page, content quality, structured data, Core Web Vitals, mobile usability, local SEO, internal linking, security, accessibility, and competitive positioning. Produces a scored audit report with prioritised action items. Works with any Astro static site. Run after deploy or on demand to identify SEO gaps and improvement opportunities.

SEO Audit Skill — Static Website Factory

Run a comprehensive SEO audit across the entire site, scoring 11 categories and producing a prioritised action plan.

When to Use

• After initial site build (post-deploy) to verify SEO implementation
• On demand when the client asks "how is my SEO?"
• Before a major content update to establish a baseline
• Periodically (quarterly) to catch regressions

Prerequisites

• Site must be built (npm run build completed, dist/ exists)
• docs/seo.md should exist (but audit works without it)
• Existing SEO skill should have run (meta tags, structured data in place)

Audit Categories (11 Total)

Each category is scored 0-10. Overall score is weighted average.

#	Category	Weight	What It Checks
1	Technical SEO	15%	Sitemap, robots.txt, canonical URLs, hreflang, crawlability
2	On-Page SEO	15%	Title tags, meta descriptions, heading hierarchy, keyword placement
3	Content Quality	10%	Unique content, word count, keyword density, E-E-A-T signals
4	Structured Data	10%	JSON-LD schemas, Organization, Service, BreadcrumbList, validation
5	Core Web Vitals	10%	Page weight, image optimisation, render-blocking resources, LCP
6	Mobile Usability	10%	Viewport meta, touch targets, responsive images, no horizontal scroll
7	Local SEO	10%	NAP consistency, geo meta tags, LocalBusiness schema, area served
8	Internal Linking	5%	Navigation structure, orphan pages, link depth, anchor text
9	Security & Trust	5%	HTTPS references, mixed content, external link safety
10	Accessibility	5%	Alt text, aria labels, heading order, skip links, focus styles
11	Competitive Positioning	5%	Keyword targeting, title uniqueness, geo-targeting, service coverage

---

How to Run the Audit

Step 1: Build the Site

npm run build

Ensure dist/ is fresh and complete.

Step 2: Collect Data

For each HTML page in dist/:

Technical SEO checks:

• sitemap-index.xml exists and lists all pages
• robots.txt exists with Sitemap directive
• Every page has <link rel="canonical"> tag
• Hreflang tags present for all enabled languages
• No duplicate content (no pages with identical titles/descriptions)
• Clean URL structure (no query params, trailing slashes consistent)

On-Page SEO checks:

• Every page has a unique <title> tag (under 60 characters ideal)
• Every page has a unique <meta name="description"> (under 160 characters)
• Title contains primary keyword for the page
• Description contains primary keyword and geo-target
• One <h1> per page that matches the page topic
• Heading hierarchy is sequential (h1 > h2 > h3, no skips)
• Primary keyword appears in first 100 words of body content

Content Quality checks:

• Each page has >300 words of unique text content
• No placeholder text ("Lorem ipsum", "[Write...]", "Coming soon" as main content)
• E-E-A-T signals present (author info, company details, credentials)
• Content addresses user search intent for target keywords

Structured Data checks:

• Organization/ProfessionalService schema on homepage
• Service schemas on service pages
• BreadcrumbList schema on all pages
• All schemas validate (no missing required fields)
• areaServed and serviceType populated
• Logo, address, contact info in Organization schema

Core Web Vitals checks:

• Total page weight under 500KB (excluding lazy images)
• All images use <img> with width/height (no CLS)
• Hero images use loading="eager", rest use loading="lazy"
• No render-blocking external scripts
• Fonts preloaded or self-hosted with font-display: swap
• CSS inlined or minimal external sheets

Mobile Usability checks:

• <meta name="viewport"> present on every page
• All touch targets >= 44x44px
• No horizontal overflow at 375px viewport
• Images use responsive srcset/sizes
• Text readable without zooming (min 16px body)
• Mobile navigation functional (hamburger menu works)

Local SEO checks:

• Business name, address, country in structured data
• Geo meta tags (geo.region, geo.placename, ICBM)
• Target location appears in titles and descriptions
• Contact page has full address and phone
• Google Business Profile mentioned or linked (if applicable)

Internal Linking checks:

• Every page reachable within 3 clicks from homepage
• No orphan pages (every page linked from at least one other)
• Navigation includes all key pages
• CTAs link to relevant internal pages
• Footer includes key page links

Security & Trust checks:

• All internal URLs use relative paths or HTTPS
• No mixed content (HTTP resources on HTTPS page)
• External links use rel="noopener" on target="_blank"
• No links to suspicious/broken external domains

Accessibility checks:

• All <img> tags have alt attributes
• Icon-only buttons have aria-label
• Skip-to-content link present
• Focus styles visible on interactive elements
• Colour contrast meets WCAG 2.1 AA (4.5:1 body, 3:1 large)
• Language attribute on <html> tag

Competitive Positioning checks:

• Target keywords covered across page titles
• Geo-targeting (city, country, region) in meta tags
• Service types match what users search for
• Unique value proposition visible above the fold
• Competitor keywords not missing from coverage

Step 3: Score Each Category

Score 0-10 per category:

• 10: Perfect — all checks pass, best practices exceeded
• 8-9: Strong — minor improvements possible
• 6-7: Adequate — some gaps, no critical issues
• 4-5: Needs work — notable gaps affecting visibility
• 2-3: Weak — significant issues
• 0-1: Critical — category largely missing

Step 4: Generate Report

Output a structured audit report:

# SEO Audit Report — [Site Name]
Date: [YYYY-MM-DD]
Site URL: [URL]
Pages audited: [count]

## Overall Score: [XX]/100

## Category Scores

| Category | Score | Status |
|----------|-------|--------|
| Technical SEO | X/10 | [pass/warn/fail] |
| On-Page SEO | X/10 | [pass/warn/fail] |
| ... | ... | ... |

## Critical Issues (Fix Immediately)
1. [Issue + how to fix]

## High Priority (Fix This Week)
1. [Issue + how to fix]

## Medium Priority (Fix This Month)
1. [Issue + how to fix]

## Low Priority (Nice to Have)
1. [Issue + how to fix]

## What's Working Well
- [Positive findings]

Step 5: Save Report

Save to docs/seo-audit-[YYYY-MM-DD].md in the project root docs directory.

---

Scoring Thresholds

Overall Score	Rating	Action
90-100	Excellent	Monitor quarterly
75-89	Good	Address high-priority items
60-74	Fair	Prioritise fixes before promotion
40-59	Poor	Significant work needed
0-39	Critical	SEO fundamentally incomplete

---

References

• references/audit-checklist.md — Detailed per-check explanations
• references/keyword-research.md — How to identify target keywords
• references/local-seo-guide.md — Local SEO best practices for African businesses

Relationship to Other Skills

• seo skill implements the SEO — this skill audits the result
• Run seo first to build the SEO layer, then run seo-audit to verify
• Findings from audit should feed back into seo skill configuration