audit
Run a comprehensive SEO audit on a website covering technical health, on-page optimization, content quality, and backlink profile. Use when the user asks for an SEO audit, site review, SEO health check, "what's wrong with my SEO", website analysis, or a full diagnostic of their site's search performance. For speed-specific issues, see audit-speed. For technical crawl/index issues only, see diagnose-seo.
What this skill does
# SEO Audit Run a comprehensive SEO audit covering technical foundations, on-page optimization, content quality, link profile, and competitive positioning. ## Before You Start Gather this context (ask if not provided): 1. **Domain.** What site are we auditing? 2. **Goals.** What are you trying to achieve? (More traffic, better rankings, fix a drop, pre-launch check) 3. **Known issues.** Anything you already suspect is wrong? 4. **Access.** Do you have Google Search Console and Google Analytics data? (Improves the audit significantly) 5. **Scope.** Full audit or focused on a specific area? (If unsure, run the full audit) ## Audit Framework A complete SEO audit covers five layers. Work through them in order — problems in earlier layers undermine everything that follows. ``` Layer 1: Technical Foundation ← Can Google crawl and index the site? Layer 2: On-Page Optimization ← Are pages optimized for target keywords? Layer 3: Content Quality ← Is the content worth ranking? Layer 4: Link Profile ← Does the site have authority? Layer 5: Competitive Position ← How does the site compare to competitors? ``` ## Layer 1: Technical Foundation Check whether search engines can properly access, crawl, render, and index the site. ### Crawlability - [ ] `robots.txt` — fetch and review. No critical paths blocked? Sitemap directive present? - [ ] XML sitemap — exists, valid XML, lists all important pages, excludes noindex/redirected pages? - [ ] Site architecture — important pages reachable within 3 clicks from homepage? - [ ] Orphan pages — any pages with zero internal links pointing to them? - [ ] Redirect chains — any paths with 2+ redirects in sequence? - [ ] HTTP status — all important pages return 200? No unexpected 301s, 404s, or soft 404s? ### Indexability - [ ] `noindex` tags — any important pages accidentally noindexed? - [ ] Canonical tags — self-referencing on all pages? No conflicting canonicals? - [ ] Duplicate content — same content accessible at multiple URLs (www/non-www, HTTP/HTTPS, trailing slash)? - [ ] Search Console index coverage — how many pages submitted vs indexed? Any excluded pages that should be indexed? ### Performance - [ ] Core Web Vitals — LCP < 2.5s, CLS < 0.1, INP < 200ms? - [ ] TTFB — < 800ms from major regions? - [ ] Mobile-friendly — passes Google's mobile usability tests? - [ ] HTTPS — enforced across the entire site? Valid certificate? ### Rendering - [ ] JavaScript-dependent content — is critical content in the initial HTML or loaded via JS? - [ ] Content visibility — can search engines see the full page content? ## Layer 2: On-Page Optimization Check whether individual pages are properly optimized for their target keywords. ### Title Tags - [ ] Every page has a unique `<title>` - [ ] Titles include the primary target keyword - [ ] Titles are under 60 characters (avoid truncation) - [ ] Titles are descriptive and click-worthy (not keyword-stuffed) ### Meta Descriptions - [ ] Every important page has a unique meta description - [ ] Descriptions are 150-160 characters - [ ] Descriptions include a value proposition and call to action ### Heading Structure - [ ] One H1 per page containing the primary keyword - [ ] Logical heading hierarchy (H1 → H2 → H3, no level skipping) - [ ] Headings describe section content accurately ### URL Structure - [ ] URLs are clean, readable, and descriptive - [ ] URLs use hyphens (not underscores) - [ ] No excessive URL parameters or session IDs in indexed URLs - [ ] Consistent URL structure across the site ### Internal Linking - [ ] Important pages have sufficient incoming internal links (3+) - [ ] Anchor text is descriptive and varied (not all "click here") - [ ] Hub-and-spoke structure exists for topic clusters - [ ] No broken internal links (404 targets) ### Image Optimization - [ ] All images have descriptive `alt` attributes - [ ] Images use modern formats (WebP/AVIF) where supported - [ ] Images are appropriately sized (not serving 4000px images in 400px containers) - [ ] Decorative images use empty `alt=""` ### Structured Data - [ ] Relevant schema markup present (Article, Product, FAQ, LocalBusiness, BreadcrumbList, etc.) - [ ] Schema validates without errors in Google's Rich Results Test - [ ] Schema matches visible page content (no hidden/misleading markup) ### On-Page Scoring Rubric For a detailed page-level audit, score each page across 8 sections: | Section | Weight | What to Score | |---------|--------|--------------| | Title Tag | 15% | Keyword presence, in first half, 50-60 chars, unique, compelling, intent match | | Meta Description | 5% | Keyword included, 150-160 chars, CTA present, unique | | Header Structure | 10% | Single H1 with keyword, logical hierarchy (no skipped levels), H2s cover subtopics | | Content Quality | 25% | Sufficient length, comprehensive, unique value, up-to-date, good formatting, E-E-A-T signals | | Keyword Optimization | 15% | Keyword in title/H1/first 100 words/URL, density 0.5-2.5%, semantic terms present | | Internal/External Links | 10% | Sufficient internal links, descriptive anchors, quality external links, no broken links | | Image Optimization | 10% | Alt text on all images, descriptive filenames, optimized sizes, modern formats | | Page-Level Technical | 10% | Clean URL, correct canonical, mobile-friendly, LCP ≤2.5s, HTTPS, schema present | **Content Length Benchmarks** (for full score on "sufficient length"): | Intent Type | Target Word Count | |------------|------------------| | Informational | 1,500+ words | | Commercial investigation | 1,200+ words | | Transactional | 500+ words | | Local | 400+ words | **Internal Link Count Guidelines:** | Page Length | Target Internal Links | |-----------|---------------------| | <500 words | 2-4 links | | 500-1,000 words | 3-6 links | | 1,000-2,000 words | 5-10 links | | 2,000+ words | 8-15 links | **Keyword density penalties:** >3.0% = keyword stuffing (score 0); <0.5% = under-optimized. **Score grade scale:** | Score | Grade | Assessment | |-------|-------|-----------| | 90-100 | A+ | Exceptional — maintain | | 80-89 | A | Strong — minor tweaks | | 70-79 | B | Good — several areas need attention | | 60-69 | C | Average — significant improvements needed | | 50-59 | D | Below average — major issues | | <50 | F | Poor — comprehensive overhaul required | ## Layer 3: Content Quality Evaluate whether the content deserves to rank. ### E-E-A-T Assessment - **Experience** — Does the content demonstrate first-hand experience with the topic? - **Expertise** — Is the content written with subject-matter depth? Does it go beyond surface-level? - **Authoritativeness** — Does the site have a reputation in this topic area? Are authors credible? - **Trustworthiness** — Are claims sourced? Is the site transparent about who publishes it? ### Content Coverage - [ ] Does each page have a clear target keyword and intent? - [ ] Is the content comprehensive enough to fully satisfy the search query? - [ ] Are there thin pages (< 300 words) that should be expanded or consolidated? - [ ] Is content up to date? Any pages with stale data, broken examples, or outdated advice? ### Content Gaps - [ ] What topics do competitors cover that this site doesn't? - [ ] Are there keywords with search demand that no existing page targets? - [ ] Are there topic clusters that are incomplete (pillar page but missing spokes, or vice versa)? ### Cannibalization - [ ] Are multiple pages targeting the same keyword? - [ ] If so, are they competing against each other in rankings? - [ ] Resolution: consolidate, differentiate, or canonical the weaker page to the stronger one. ## Layer 4: Link Profile Assess the site's backlink authority and quality. ### Backlink Overview - Total referring domains - Dofollow vs nofollow ratio - Link acquisition trend (growing, stable, or declining?) - Average authority of linking domains ### Link Quality - [ ] Any high-spam-score referring domains that
Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".