---
name: seo-audit-8564531a6aad
description: Full SEO and performance audit for any website. Use when asked to check SEO, run a lighthouse scan, audit performance, check accessibility, or validate structured data.
metadata:
  category: user-invoked
disable-model-invocation: true
---

Default output: return only the result, blockers, and required evidence. Omit preambles, process narration, repeated context, confidence scores, and follow-up offers. Use at most five bullets unless a required artifact or schema needs more.

# SEO Audit Skill

## When to Use
- User says "SEO audit", "check SEO", "lighthouse scan", "performance check", "site audit"
- Need to validate SEO, accessibility, performance, or structured data

## Workflow

### 1. Lighthouse Scan
Run Lighthouse via CLI for both mobile and desktop:

```bash
# Install if needed
npx --yes lighthouse

# Run scans
npx lighthouse URL --output=json --output-path=./lighthouse-mobile.json --emulated-form-factor=mobile --quiet
npx lighthouse URL --output=json --output-path=./lighthouse-desktop.json --emulated-form-factor=desktop --quiet
```

Extract and report:
- **Performance** (target: 90+)
- **Accessibility** (target: 100)
- **Best Practices** (target: 100)
- **SEO** (target: 90+)

### 2. Core Web Vitals
From Lighthouse results, extract and assess:
- **LCP** (Largest Contentful Paint) — target: <2.5s
- **FID** (First Input Delay) — target: <100ms
- **CLS** (Cumulative Layout Shift) — target: <0.1
- **INP** (Interaction to Next Paint) — target: <200ms
- **TTFB** (Time to First Byte) — target: <800ms

Flag any that fail and identify the cause.

### 3. Meta Tags Audit
Fetch the page HTML and check:
- [ ] `<title>` present, 30-60 chars, unique per page
- [ ] `<meta name="description">` present, 120-160 chars
- [ ] Open Graph tags: `og:title`, `og:description`, `og:image`, `og:url`
- [ ] Twitter Card tags: `twitter:card`, `twitter:title`, `twitter:description`, `twitter:image`
- [ ] `<meta name="viewport">` present
- [ ] `<link rel="canonical">` set correctly
- [ ] `<meta name="robots">` not blocking important pages
- [ ] Hreflang tags for multilingual sites

### 4. Heading Hierarchy
Parse headings and check:
- [ ] Exactly one `<h1>` per page
- [ ] Logical hierarchy (H1 → H2 → H3, no skipping levels)
- [ ] Headings contain relevant keywords
- [ ] No empty heading tags

### 5. Image Audit
Scan all `<img>` tags:
- [ ] All images have `alt` text
- [ ] `width` and `height` attributes set (prevents CLS)
- [ ] Images use modern formats (WebP, AVIF)
- [ ] Lazy loading applied (`loading="lazy"`) for below-fold images
- [ ] No oversized images (check natural vs display size)
- [ ] Decorative images have empty alt (`alt=""`)

### 6. Link Audit
Check all links on the page:
- [ ] No broken internal links (404s)
- [ ] No broken external links
- [ ] External links use `rel="noopener"` for `target="_blank"`
- [ ] Descriptive anchor text (no "click here")
- [ ] No orphaned pages (pages with no internal links to them)

### 7. Sitemap & Robots.txt
- [ ] `sitemap.xml` exists and is valid XML
- [ ] `sitemap.xml` referenced in `robots.txt`
- [ ] `robots.txt` exists and is not overly restrictive
- [ ] All important pages are in sitemap
- [ ] Sitemap last modified date is recent

### 8. Structured Data / Schema
Check for JSON-LD structured data:
- [ ] Valid JSON-LD present
- [ ] Schema type appropriate for page content
- [ ] Common schemas: Organization, WebSite, BreadcrumbList, Article, FAQPage, LocalBusiness
- [ ] No schema errors or warnings (validate with Google Rich Results Test logic)
- [ ] `@id` and `url` fields consistent

### 9. Technical SEO
- [ ] HTTPS enforced (redirects HTTP → HTTPS)
- [ ] WWW/non-WWW canonical redirect
- [ ] No mixed content warnings
- [ ] Proper 404 page
- [ ] 301/302 redirects working correctly
- [ ] No redirect chains (3+ hops)
- [ ] Compression enabled (gzip/brotli)
- [ ] Browser caching headers set
- [ ] No render-blocking resources

### 10. Mobile & Accessibility
- [ ] Responsive meta viewport tag
- [ ] Touch targets >= 48px
- [ ] Text readable without zooming
- [ ] No horizontal scroll on mobile
- [ ] ARIA labels on interactive elements
- [ ] Color contrast ratio >= 4.5:1
- [ ] Form labels present
- [ ] Skip navigation link

## Output Format

```
═══════════════════════════════════════
SEO AUDIT: [URL]
Date: [YYYY-MM-DD]
═══════════════════════════════════════

LIGHTHOUSE SCORES
                 Desktop    Mobile
Performance        [XX]       [XX]
Accessibility      [XX]       [XX]
Best Practices     [XX]       [XX]
SEO                [XX]       [XX]

CORE WEB VITALS
LCP:  [X.Xs]  [✓/✗ target: <2.5s]
FID:  [Xms]   [✓/✗ target: <100ms]
CLS:  [X.XX]  [✓/✗ target: <0.1]

META TAGS         [✓/✗] [issue count]
HEADINGS          [✓/✗] [issue count]
IMAGES            [✓/✗] [issue count]
LINKS             [✓/✗] [broken count]
SITEMAP           [✓/✗]
STRUCTURED DATA   [✓/✗]
TECHNICAL SEO     [✓/✗]
MOBILE/A11Y       [✓/✗]

═══════════════════════════════════════
ISSUES FOUND
═══════════════════════════════════════

🔴 CRITICAL
[Issues that severely impact rankings or UX]

🟡 WARNING
[Issues that should be fixed]

🟢 SUGGESTIONS
[Nice-to-have improvements]

═══════════════════════════════════════
RECOMMENDATIONS
═══════════════════════════════════════
1. [Most impactful fix first]
2. [Second most impactful]
3. [Third]
```

## Usage

```
# Single page audit
/seo-audit https://example.com

# Full site audit (crawls linked pages)
/seo-audit https://example.com --full

# Compare before/after
/seo-audit https://example.com --compare ./previous-audit.json
```

## Multi-Page Mode (--full)
When `--full` is specified:
1. Start with the provided URL
2. Crawl all internal links (same domain)
3. Run full audit on each page
4. Generate aggregate report with worst offenders
5. List pages sorted by score (lowest first)


---
Source attribution: v1truv1us
Original project: https://github.com/v1truv1us/ai-eng-system/blob/eaff192b6e8bcb204a1f1b132b98f748a9b4572e/skills/seo-audit/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2025 John Ferguson

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: v1truv1us
Original project: https://github.com/v1truv1us/ai-eng-system/blob/eaff192b6e8bcb204a1f1b132b98f748a9b4572e/skills/seo-audit/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing
Roles: Content Marketer, Marketing Analyst, SEO Specialist
Specialties: Cross Platform
Tools: Tool not specified
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: ffbb6ff637973f20128bf5a9462354b98bf3ba3162bfc4549dfb800c17997b54