SEO Auditor Skill

Description

This skill performs in-depth SEO audits of web pages and applications. It analyzes HTML meta tags, structured data (JSON-LD), Open Graph tags, Core Web Vitals, internal link structure, sitemap validity, and robots.txt configuration. Outputs a prioritized report with specific code fixes for each issue found.

Instructions

1. Crawl Analysis: Check robots.txt, sitemap.xml, and page crawlability
2. On-Page SEO: Audit title tags, meta descriptions, headings hierarchy, and canonical URLs
3. Structured Data: Validate JSON-LD schema markup against Google's requirements
4. Performance: Check Core Web Vitals indicators in the code
5. Technical: Verify proper use of canonical, hreflang, pagination, and redirects

Rules

• Title tags: 50-60 characters, unique per page, primary keyword near the front
• Meta descriptions: 150-160 characters, include call-to-action, unique per page
• Every page must have exactly one <h1> tag
• Heading hierarchy must not skip levels (h1 → h3 is wrong, must go h1 → h2 → h3)
• All images must have descriptive alt attributes (not just filenames)
• Canonical URLs must be absolute, not relative
• JSON-LD structured data must pass Google's Rich Results validator
• Internal links should use descriptive anchor text, not "click here"
• Every meaningful page must be in the sitemap
• Robots.txt must not block CSS/JS files needed for rendering

Audit Checklist

Meta Tags

Copy
<!-- Required -->
<title>Primary Keyword - Secondary Keyword | Brand (50-60 chars)</title>
<meta name="description" content="Compelling description with keyword. Call to action. (150-160 chars)">
<link rel="canonical" href="https://example.com/page/">
<meta name="robots" content="index, follow">

<!-- Open Graph -->
<meta property="og:title" content="Page Title">
<meta property="og:description" content="Description for social sharing">
<meta property="og:image" content="https://example.com/og-image.jpg">
<meta property="og:url" content="https://example.com/page/">
<meta property="og:type" content="website">

<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Page Title">
<meta name="twitter:description" content="Description">
<meta name="twitter:image" content="https://example.com/twitter-card.jpg">

<!-- International -->
<link rel="alternate" hreflang="en" href="https://example.com/page/">
<link rel="alternate" hreflang="es" href="https://example.com/es/page/">
<link rel="alternate" hreflang="x-default" href="https://example.com/page/">

JSON-LD Structured Data

Copy
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Article Title",
  "description": "Brief description",
  "image": "https://example.com/image.jpg",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Site Name",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "datePublished": "2025-03-15",
  "dateModified": "2025-03-20"
}
</script>

Audit Report Template

Copy
# SEO Audit Report: [URL]

## Score: 72/100

| Category | Score | Issues |
|----------|-------|--------|
| Meta Tags | 8/10 | 2 warnings |
| Content | 7/10 | 3 issues |
| Structured Data | 6/10 | 2 errors |
| Performance | 8/10 | 1 warning |
| Crawlability | 9/10 | 1 issue |
| Mobile | 10/10 | None |

## Critical Issues (Fix Immediately)
1. **Missing canonical URL** on 3 pages → Add `<link rel="canonical">`
2. **Duplicate title tags** on /about and /about-us

## Warnings (Fix Soon)
3. **Meta description too long** (187 chars) on homepage
4. **H1 missing** on /contact page
5. **Images without alt text**: 12 images across 4 pages

## Opportunities
6. Add FAQ structured data to /pricing (eligible for rich results)
7. Add breadcrumb structured data to blog posts

Examples

"Audit the SEO of our homepage HTML"
"Check our JSON-LD structured data for errors"
"Generate a sitemap.xml for our Next.js app"
"Review our robots.txt and suggest improvements"
"Add proper meta tags to our React app's head"