An 8-dimension audit tool that scans and auto-fixes search and site health issues.

Install

mkdir -p .claude/skills/rank-audit && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11237" && unzip -o skill.zip -d .claude/skills/rank-audit && rm skill.zip

Installs to .claude/skills/rank-audit

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Full SEO/GEO/AEO/Citability/Content/Performance/Vertical/Security audit with auto-fix. Scans, reports, fixes, and verifies.
123 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Scans web projects across 8 SEO/GEO/AEO dimensions
  • Generates scored optimization reports
  • Applies automated fixes for metadata and schema
  • Verifies improvements with before/after comparisons
  • Provides search console action plans

How it works

It runs parallel scanners to identify issues in SEO, performance, and security, then applies automated fixes to HTML and configuration files before re-verifying scores.

Inputs & outputs

You give it
Project directory path
You get back
Optimization score report and fixed files

When to use rank-audit

  • Identify missing meta tags or alt text
  • Scan web project for security vulnerabilities
  • Generate site optimization score report

About this skill

Full Audit

Comprehensive search optimization audit across 8 dimensions. Finds issues AND fixes them.

Phase 1: Parallel Scan

Run all eight scanners:

node ${CLAUDE_PLUGIN_ROOT}/tools/seo-scanner.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/geo-scanner.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/aeo-scanner.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/citability-scorer.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/content-analyzer.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/perf-scanner.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/vertical-scanner.mjs <project-directory>
node ${CLAUDE_PLUGIN_ROOT}/tools/security-scanner.mjs <project-directory>

Parse JSON output from each for findings and scores.

Phase 2: Report

Present findings grouped by all 8 categories with severity.

Show scores table:

CategoryScore
SEO--
GEO--
AEO--
Citability--
Content--
Performance--
Vertical--
Security--
Overall--

Show summary: X critical, Y high, Z medium, W low across all categories.

Phase 3: Auto-Fix

For each finding, apply the appropriate fix:

SEO fixes (Edit tool on HTML files):

  • Missing title → add <title> in <head>
  • Missing meta description → add <meta name="description">
  • Missing OG tags → generate from page content
  • Missing H1 → add heading from page content
  • Missing alt text → add descriptive alt attributes
  • Missing canonical → add <link rel="canonical">
  • Missing sitemap → run: node ${CLAUDE_PLUGIN_ROOT}/tools/sitemap-analyzer.mjs generate <dir> <url>
  • Missing robots.txt → run: node ${CLAUDE_PLUGIN_ROOT}/tools/robots-analyzer.mjs generate <dir> <url>

GEO fixes:

  • Missing llms.txt → run: node ${CLAUDE_PLUGIN_ROOT}/tools/llms-txt-generator.mjs <dir>
  • Missing structured data → run: node ${CLAUDE_PLUGIN_ROOT}/tools/schema-engine.mjs generate <type> --out=<path>
  • Blocked AI bots → update robots.txt to allow GPTBot, PerplexityBot, ClaudeBot, Google-Extended
  • Improve content structure: add question-based H2s, TL;DR summaries, definition patterns

AEO fixes:

  • Missing FAQ schema → generate FAQPage from Q&A content on page
  • Missing speakable → add speakable schema for key content sections
  • Snippet optimization → restructure answers to 40-60 word direct answers

Performance fixes:

  • Missing image dimensions → add width and height attributes to all <img> tags
  • Render-blocking scripts → add async or defer to third-party <script> tags
  • Font display issues → add font-display: swap to @font-face declarations
  • Lazy loading → add loading="lazy" to below-fold images
  • LCP priority → add fetchpriority="high" to the LCP image (hero/above-fold)
  • Missing preconnect → add <link rel="preconnect"> hints for third-party origins (fonts, CDNs, analytics)

Security fixes:

  • Missing CSP → add <meta http-equiv="Content-Security-Policy" content="..."> in <head>
  • Missing referrer policy → add <meta name="referrer" content="strict-origin-when-cross-origin">
  • Unsafe target="_blank" → add rel="noopener noreferrer" to all target="_blank" links
  • Unsandboxed iframes → add sandbox attribute to <iframe> elements
  • Mixed content → fix http:// URLs to https:// in src, href, and content attributes

Content fixes:

  • Long paragraphs → break up paragraphs longer than 150 words into smaller chunks
  • Complex sentences → simplify sentences with Flesch-Kincaid grade level > 12
  • Passive voice → rewrite passive voice constructions to active voice

Vertical fixes:

  • Missing Product schema → add Product JSON-LD for e-commerce product pages
  • Missing LocalBusiness schema → add LocalBusiness JSON-LD with business details
  • Missing NAP data → add Name, Address, Phone in structured data and visible on page
  • Missing opening hours → add openingHoursSpecification to LocalBusiness schema

Phase 4: Verify

Re-run all eight scanners. Show before/after score comparison for each category.

Phase 5: Save History

node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> seo <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> geo <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> aeo <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> citability <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> content <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> performance <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> vertical <score>
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save <dir> security <score>

Phase 6: Content Strategy

Advise on content optimizations the scanner cannot automate:

  • Rewrite H2 headers as questions for AI citation
  • Add concise TL;DR summaries under key sections
  • Write in citation-ready format: factual, quotable, 134-167 word passages
  • Create comparison tables, statistics pages, glossaries

Phase 7: Backlink Strategy

Guide link building: create link-worthy assets, guest posting, broken link building, digital PR, expert roundups.

Phase 8: Search Console Action Plan

After fixing issues, guide the user through submitting their improved site to search engines.

Google Search Console (GSC)

  1. Submit Sitemap — GSC → Sitemaps → Enter sitemap.xml → Submit
  2. Request Indexing for Money Pages — URL Inspection → paste each fixed page → Request Indexing (10-12/day limit, prioritize homepage, pricing, top landing pages)
  3. Check Index Coverage — Pages → review "Not indexed" list. "Crawled - currently not indexed" = needs content/links. "Discovered - currently not indexed" = needs internal links.
  4. Validate Robots.txt — Settings → Crawling → verify AI bots are unblocked
  5. Check Rich Results — Enhancements → review schema types. Test with Rich Results Test.
  6. Monitor Core Web Vitals — Experience → Core Web Vitals → fix "Poor" URLs (LCP, CLS, INP)

Bing Webmaster Tools

  1. Submit Sitemap — Configure Sitemaps → submit sitemap.xml URL
  2. Submit URLs — URL Submission → submit top pages (10,000/day limit)
  3. Enable IndexNow — Generate key at indexnow.org → place key file at domain root. Feeds Bing, Yandex, Seznam.
  4. Verify Robots.txt — Configure My Site → Block URLs → Robots.txt Tester. Bingbot feeds Copilot and ChatGPT Browse.

AI Search Verification

  1. Test AI Visibility (2-4 weeks after deploy) — search brand + keywords in ChatGPT, Perplexity, Gemini, Google AI Overviews
  2. Verify llms.txt — confirm https://yourdomain.com/llms.txt returns content
  3. Monitor AI Citations Weekly — track which pages get cited vs competitors in Perplexity and ChatGPT

Phase 9: Next Steps

Recommend which /claude-rank sub-commands to run next based on lowest scores. Prioritize by score:

  • If SEO < 60, run /claude-rank:rank-seo for detailed on-page analysis
  • If GEO < 60, run /claude-rank:rank-geo for AI visibility deep-dive
  • If AEO < 60, run /claude-rank:rank-aeo for snippet and voice optimization
  • If Citability < 50, run /claude-rank:rank-citability for detailed per-page citation breakdown across all 7 dimensions
  • If Content < 50, run /claude-rank:rank-content for readability analysis and thin page identification
  • If Performance < 50, run /claude-rank:rank-performance for CLS/LCP/blocking resource analysis
  • If Vertical < 50, run /claude-rank:rank-vertical for industry-specific schema and optimization
  • If Security < 50, run /claude-rank:rank-security for header analysis and CSP configuration

Present the user with a prioritized action checklist ordered by impact (lowest scores first).

When not to use it

  • Manual code-level security auditing
  • Secrets scanning of git history

Prerequisites

node

Limitations

  • Not a substitute for deep manual security audits
  • Cannot automate all content strategy improvements

How it compares

It combines scanning, reporting, and automated code-level fixing in a single workflow, rather than just providing a diagnostic report.

Compared to similar skills

rank-audit side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
rank-audit (this skill)04moReviewIntermediate
seo03moNo flagsIntermediate
seo-review97moNo flagsIntermediate
google-ads04moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry