Agent skill · marketing growth · alirezarezvani
seo-audit
Find why a site is not ranking: technical SEO, on-page issues, meta tags, site health. Use whenever the user asks why a page is not on Google, why traffic dropped or for an SEO audit.
Why this skill is useful
Adds specific Python scripts for SEO checking and health scoring that are not widely known.
What it needs
Requires python3 installed locally. Requires google-search-console account access. About 4k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
SEO Audit You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance. Initial Assessment Check for product marketing context first: If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. Before auditing, understand: 1. Site Context What type of site? (SaaS, e-commerce, blog, etc.) What's the primary business goal for SEO? What keywords/topics are priorities? 2. Current State Any known issues or concerns? Current organic traffic level? Recent changes or migrations? 3. Scope Full site audit or specific pages? Technical + on-page, or one focus area? Access to Search Console / analytics? --- Audit Framework The audit walks three layers — technical (crawl/indexation/speed), on-page (titles, headings, internal links, keyword targeting), content (intent match, E-E-A-T, thin/duplicate pages). Full framework: references/seo-audit-reference.md. Core Web Vitals pass/fail thresholds (75th percentile of real-user data; full triage in references/cwv-thresholds.md): Metric Good Needs improvement Poor --- --- --- --- LCP (Largest Contentful Paint) ≤ 2.5s 2.5-4.0s > 4.0s INP (Interaction to Next Paint) ≤ 200ms 200-500ms > 500ms CLS (Cumulative Layout Shift) ≤ 0.1 0.1-0.25 > 0.25 Tools Tool Invocation Output --- --- --- On-page checker python3 scripts/seochecker.py --file page.html (or --url https://...; --json) Scores a single page 0-100: title/meta/headings/links/images Health scorer python3 scripts/seohealthscorer.py --checks checks.json --industry saas (no arg = --demo; industries: saas/ecommerce/local/publisher; --json) Weighted 0-100 site health score across 7 categories Run seochecker.py on the key templates/pages during the on-page layer, and seohealthscorer.py on the completed check matrix to produce the audit's headline score. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/seo-audit--33ae6f