Agent skill

SEO Audit

by Affitor in Affitor/affiliate-skills

Audit affiliate blog posts and landing pages for SEO issues.

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add Affitor/affiliate-skills --skill seo-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Affitor/affiliate-skills seo-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Affitor/affiliate-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/analytics/seo-audit .claude/skills/seo-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-audit
GitHub stars
699
Token cost
~2.4k tokens
SKILL.md length
1,004 words
Files
2
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Audit affiliate blog posts and landing pages for SEO issues.

  • Works in 9 steps: Analyze Content Structure → Check Keyword Usage → Evaluate Meta Tags → …
  • : audit my blog post for SEO
  • SKILL.md covers Stage, When to Use, Input Schema and Workflow, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Audit is an agent skill from Affitor/affiliate-skills. 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".

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file. Compatibility notes: Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent

It sits in Marketing & SEO, covering On-page SEO, SEO audit and Blog and article writing. The repository describes itself as: 50 AI agent skills for affiliate marketing. Research trending content, write data-backed posts, generate infographics, build landing pages, deploy — full flywheel with social… The licence is MIT.

When your agent uses it

  • : audit my blog post for SEO
  • Improve my rankings
  • On-page SEO audit
  • Keyword optimization check

Example prompts

  • “audit my blog post for SEO”
  • “check my SEO”
  • “SEO review”
  • “/seo-audit”

Requirements

  • Compatibility (from SKILL.md): Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Analyze Content Structure
  2. Check Keyword Usage
  3. Evaluate Meta Tags
  4. Check E-E-A-T Signals
  5. Check Affiliate Link Attributes
  6. Check Internal Linking
  7. Score on 10 Dimensions
  8. Generate Fix-It Checklist
  9. Self-Validation

What it can do on your machine

Read from SKILL.md and the folder at commit e43bfae. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent

    From compatibility in the SKILL.md frontmatter.

Context cost

SEO Audit loads about 2.4k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 1,004 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Affitor/affiliate-skills at commit e43bfae, republished under its MIT licence (© Affitor). 1,004 words, ~2,449 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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".
compatibility
Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent
license
MIT
version
1.0.0
tags
affiliate-marketing, analytics, optimization, tracking, seo, technical-seo
metadata.author
affitor
metadata.version
1.0
metadata.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

yaml
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)?

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

yaml
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: string
    fix: string                # specific action to take
    impact: string             # "high" | "medium" | "low"

checklist:
  - task: string
    priority: string
    done: boolean              # always false (user checks off)

Output Format

  1. SEO Scorecard — table with 10 dimensions, scores, and status
  2. Overall Score — X/100 with assessment (Excellent >80, Good 60-80, Needs Work 40-60, Critical <40)
  3. Quick Wins — fixes that take <5 minutes and have high impact
  4. Full Fix-It Checklist — all issues ordered by priority with specific actions
  5. Competitor Comparison — brief notes if competitor URLs were provided
Show full SKILL.md (380 more words)Show less

Error Handling

  • No content provided: "Paste the content of your blog post or landing page. I'll audit it for SEO issues and give you a prioritized fix-it list."
  • No target keyword: "What keyword are you trying to rank for? (e.g., 'HeyGen review', 'best AI video tools'). This helps me check keyword usage and optimization."
  • Content is too short (<300 words): "This content is quite short (X words). For competitive keywords, aim for 1,500+ words. I'll audit what's here, but content depth is likely your biggest SEO issue."
  • URL provided but cannot be fetched: "I couldn't fetch that URL. Paste the page content directly and I'll audit it."

Examples

Example 1: Blog post with common issues

User: "Audit this blog post for 'best AI video tools': [pastes 2000-word blog post]" Action: Score each dimension. Common findings: keyword not in H1 (fix: add to title), affiliate links missing rel="nofollow sponsored" (fix: add attributes), no meta description (fix: write one), thin intro section (fix: expand first paragraph). Overall score: 62/100. Quick wins: meta description, H1 keyword, link attributes.

Example 2: Landing page audit

User: "Check the SEO on my HeyGen landing page" [content from S4 in conversation] Action: Pull landing page content from S4 output. Note: landing pages are typically not SEO-optimized (they're conversion-focused). Score accordingly — different expectations for landing pages vs blog posts. Focus on: title tag, meta description, canonical, affiliate link compliance.

Example 3: Competitive comparison

User: "Audit my Semrush review and compare to these competitor pages: [competitor URLs]" Action: Audit user's content first. Then use web_search or web_browse to analyze competitor content structure (word count, headings, topics covered). Identify content gaps — topics competitors cover that the user doesn't. Recommend additions to improve competitiveness.

References

  • shared/references/ftc-compliance.md — FTC disclosure requirements for affiliate content. Checked in Step 5.
  • shared/references/affiliate-glossary.md — SEO and affiliate terminology. Referenced throughout.
  • shared/references/flywheel-connections.md — master flywheel connection map

Flywheel Connections

Feeds Into
  • monopoly-niche-finder (S1) — ranking data reveals niches you're already winning in
  • keyword-cluster-architect (S3) — ranking gaps reveal keyword opportunities
  • content-decay-detector (S3) — declining pages to investigate
  • internal-linking-optimizer (S6) — link structure issues to fix
Fed By
  • github-pages-deployer (S5) — deployed site URL to audit
  • affiliate-blog-builder (S3) — published articles to audit
Feedback Loop
  • SEO audit results feed back to S3 Blog (content improvements) and S1 Research (niche opportunities from ranking data) — closing the SEO flywheel
yaml
chain_metadata:
  skill_slug: "seo-audit"
  stage: "analytics"
  timestamp: string
  suggested_next:
    - "content-decay-detector"
    - "internal-linking-optimizer"
    - "keyword-cluster-architect"

© Affitor, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/analytics/seo-audit of Affitor/affiliate-skills.

  • SKILL.md
  • LICENSE.txt

Open the folder on GitHubat commit e43bfae

Compare with similar skills

SEO Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Audit this skillAffitor/affiliate-skills699—~2.4kAutomated safety check: PassMIT
Content Writeraaron-he-zhu/aaron-marketing-skills2.9k—~3.6kAutomated safety check: PassApache-2.0
Content SEOjdevalk/skills104—~2.3kAutomated safety check: PassMIT
SEO Performance Reviewfjrevoredo/mini-diarium308—~3kAutomated safety check: PassMIT
SEO Content Writernowork-studio/notfair-plugin3.9k—~3.5kAutomated safety check: PassMIT
SEO Drift MonitorAgriciDaniel/claude-seo18k1 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Content Writer

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "write SEO content", "draft a blog post / landing page", "update outdated content", or "fix traffic/ranking decay"; two modes — new drafts pages with…

    2.9k GitHub stars~3.6k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Content SEO

    jdevalk/skills

    Audits a blog post draft or page copy for content-level SEO: search intent fit, focus keyphrase placement, E-E-A-T signals (experience, expertise, authoritativeness, trustworthiness), helpfulness…

    104 GitHub stars~2.3k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • SEO Performance Review

    fjrevoredo/mini-diarium

    Applies to Mini Diarium's marketing site (website/) and its SEO data under docs/seo/.

    308 GitHub stars~3k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • SEO Content Writer

    nowork-studio/notfair-plugin

    Writes SEO blog posts and landing pages, or improves existing pages, to Google's E-E-A-T and helpful-content standards from a target keyword.

    3.9k GitHub stars~3.5k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • SEO Drift Monitor

    AgriciDaniel/claude-seo

    Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

    18k GitHub starsUsed in 1 repo~1.9k tokens
    Marketing & SEOAuto-check passed
  • SEO Optimizer

    ailabs-393/ai-labs-claude-skills

    This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.

    454 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed

More from Affitor/affiliate-skills

All 50 skills in this repo
  • Performance Report

    Affitor/affiliate-skills

    Generate affiliate performance reports with KPIs and recommendations.

    699 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Affiliate Check

    Affitor/affiliate-skills

    Live affiliate program data from openaffiliate.dev. An agent skill from Affitor/affiliate-skills.

    699 GitHub stars~808 tokensUpdated 23 days ago
    Auto-check: notes
  • Affiliate Program Search

    Affitor/affiliate-skills

    Research and evaluate affiliate programs to find the best ones to promote.

    699 GitHub stars~2.4k tokensUpdated 23 days ago
    Auto-check passed
  • Bio Link Deployer

    Affitor/affiliate-skills

    Create a Linktree-style bio link hub page as a single self-contained HTML file.

    699 GitHub stars~3k tokensUpdated 23 days ago
    Auto-check passed
  • Conversion Tracker

    Affitor/affiliate-skills

    Set up affiliate conversion tracking with UTM parameters and link tagging.

    699 GitHub stars~2.1k tokensUpdated 23 days ago
    Auto-check passed
  • Product Showcase Page

    Affitor/affiliate-skills

    Build a single-product deep-dive showcase page as a self-contained HTML file.

    699 GitHub stars~3.6k tokensUpdated 23 days ago
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

Audit affiliate blog posts and landing pages for SEO issues. SEO Audit is an agent skill from Affitor/affiliate-skills. Audit affiliate blog posts and landing pages for SEO issues.

When should I use SEO Audit?

SEO Audit fits situations like: : audit my blog post for SEO; improve my rankings; on-page SEO audit; keyword optimization check.

How do I install SEO Audit in Claude Code?

Run `npx skills add Affitor/affiliate-skills --skill seo-audit -a claude-code`. Or copy the skill folder (skills/analytics/seo-audit in Affitor/affiliate-skills) into .claude/skills/seo-audit in your project. Claude Code loads it when a task matches its description.

How do I install SEO Audit in Codex?

Run `npx skills add Affitor/affiliate-skills --skill seo-audit -a codex`. Or copy the skill folder (skills/analytics/seo-audit in Affitor/affiliate-skills) into .agents/skills/seo-audit in your project. Codex loads it when a task matches its description.

Can I use SEO Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Affitor/affiliate-skills --skill seo-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-audit, .gemini/skills/seo-audit, .github/skills/seo-audit and .opencode/skills/seo-audit in your project.

What does SEO Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Audit is instructions for the agent only. Compatibility (from SKILL.md): Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent.

Does SEO Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Audit use?

SEO Audit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Audit use?

About 2.4k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Audit?

Skills that share tags, products or a category with SEO Audit: Content Writer (aaron-he-zhu/aaron-marketing-skills, 2.9k stars), Content SEO (jdevalk/skills, 104 stars), SEO Performance Review (fjrevoredo/mini-diarium, 308 stars) and SEO Content Writer (nowork-studio/notfair-plugin, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

Affitor (a GitHub organization) maintains it in Affitor/affiliate-skills, which has 699 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on September 15, 2026.

Source: Affitor/affiliate-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.