/seo-audit

name: seo-audit
description: >
  Audit affiliate blog posts and landing pages for SEO issues. Triggers on:
  "audit my blog post for SEO", "check my SEO", "SEO review", "improve my rankings",
  "SEO checklist", "on-page SEO audit", "keyword optimization check",
  "why isn't my page ranking", "SEO score", "content quality audit",
  "check my meta tags", "internal linking audit", "quick SEO wins".
license: MIT
version: "1.0.0"
tags: ["affiliate-marketing", "analytics", "optimization", "tracking", "seo", "technical-seo"]
compatibility: "Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent"
metadata:
  author: affitor
  version: "1.0"
  stage: S6-Analytics

SEO Audit

Audit affiliate blog posts and landing pages for SEO issues — on-page optimization, keyword usage, meta tags, content quality signals, affiliate link attributes, and internal linking. Output is a 10-dimension SEO scorecard with a prioritized fix-it checklist.

Stage

S6: Analytics — 53% of all website traffic comes from organic search. For affiliate bloggers, SEO is the most sustainable traffic source — but most affiliate content has basic SEO mistakes that tank rankings. This skill catches those mistakes and provides quick wins.

When to Use

• User has a blog post or landing page and wants an SEO review
• User asks "why isn't my page ranking?" or "check my SEO"
• User wants to improve search rankings for affiliate content
• User says "SEO audit", "SEO checklist", "on-page optimization"
• User wants to check affiliate link attributes (nofollow, sponsored)
• Chaining from S3 (blog) or S4 (landing): audit content before or after publishing

Input Schema

content: string                # REQUIRED — the content to audit (markdown, HTML, or URL)
                               # If URL, will attempt to fetch and analyze

target_keyword: string         # REQUIRED — primary keyword to optimize for
                               # (e.g., "best AI video tools", "HeyGen review")

content_type: string           # OPTIONAL — "blog_post" | "landing_page"
                               # Default: "blog_post"

competitor_urls:               # OPTIONAL — competitor pages to compare against
  - string                     # e.g., ["competitor.com/heygen-review"]

secondary_keywords:            # OPTIONAL — additional keywords to check
  - string                     # e.g., ["AI video generator", "HeyGen pricing"]

**Chaining context**: If S3 (blog) or S4 (landing page) was run in the same conversation, pull the generated content directly for audit. The user should not have to paste content just generated.

Workflow

Step 1: Analyze Content Structure

Check:

• **Word count**: Is it competitive? (blog: 1500+ words, landing: varies)
• **Heading structure**: H1 present and unique? H2/H3 hierarchy logical?
• **Paragraph length**: Short paragraphs for readability?
• **Content depth**: Does it cover the topic comprehensively?

Step 2: Check Keyword Usage

Analyze:

• **Title tag**: Contains target keyword? Under 60 characters?
• **H1**: Contains target keyword?
• **First 100 words**: Keyword appears naturally?
• **Keyword density**: 1-2% optimal (not stuffing, not absent)
• **Keyword in subheadings**: At least one H2 contains keyword or variant?
• **LSI keywords**: Related terms present for topical depth?

Step 3: Evaluate Meta Tags

Check:

• **Title tag length**: 50-60 characters optimal
• **Meta description**: Present? 150-160 characters? Contains keyword? Compelling?
• **OG tags**: Open Graph tags for social sharing
• **Canonical URL**: Present and correct?

Step 4: Check E-E-A-T Signals

Evaluate:

• **Experience**: First-person experience with the product?
• **Expertise**: Author credentials or demonstrated knowledge?
• **Authoritativeness**: Citing sources, linking to official pages?
• **Trustworthiness**: Transparent disclosure, balanced (pros AND cons)?

Step 5: Check Affiliate Link Attributes

Verify:

• All affiliate links have `rel="nofollow sponsored"` (Google requirement)
• Links are not cloaked in a way that violates search guidelines
• FTC disclosure is present and above the fold
• Links open in new tab (`target="_blank"`) for UX

Step 6: Check Internal Linking

Evaluate:

• Links to related content on the same site?
• Anchor text is descriptive (not "click here")?
• Table of contents for long content?

Step 7: Score on 10 Dimensions

Rate each 1-10: 1. Keyword optimization 2. Content depth and quality 3. Title tag and meta description 4. Heading structure 5. E-E-A-T signals 6. Affiliate link compliance 7. Internal linking 8. Readability and formatting 9. Mobile friendliness indicators 10. Technical SEO basics

Step 8: Generate Fix-It Checklist

Prioritize fixes by impact:

• **Quick wins**: Fix in 5 minutes, big impact (meta tags, keyword in H1)
• **Medium effort**: Fix in 30 minutes (add sections, improve depth)
• **Major revision**: Fix in 2+ hours (restructure content, add original research)

Step 9: Self-Validation

Before presenting output, verify:

• [ ] All 10 SEO dimensions scored (1-10 each)
• [ ] Overall score is weighted sum of dimension scores
• [ ] Issues prioritized: quick_win → medium → major
• [ ] Each fix is specific and actionable (not generic advice)
• [ ] Keyword density recommendation is 1-2% (not higher)

If any check fails, fix the output before delivering. Do not flag the checklist to the user — just ensure the output passes.

Output Schema

output_schema_version: "1.0.0"  # Semver — bump major on breaking changes
audit:
  url_or_title: string
  target_keyword: string
  overall_score: number        # out of 100 (sum of 10 dimensions × 10)
  word_count: number

scores:
  - dimension: string
    score: number              # 1-10
    status: string             # "good" | "needs_work" | "critical"
    notes: string

issues:
  - priority: string           # "quick_win" | "medium" | "major"
    dimension: string
    issue: