/seo-audit
Run a full technical and on-page SEO audit on any website or page. Use when the user says "audit my site", "SEO check", "technical SEO review", "site health", "check my SEO", "what's wrong with my site", or provides a URL and asks for SEO feedback.
$ npx -y skills add openclaudia/openclaudia-skills --skill seo-audit --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/seo-audit
Context preview
The summary Claude sees to decide when to auto-load this skill.
Run a full technical and on-page SEO audit on any website or page. Use when the user says "audit my site", "SEO check", "technical SEO review", "site health", "check my SEO", "what's wrong with my site", or provides a URL and asks for SEO feedback.
SKILL.md
seo-audit.SKILL.mdname: seo-audit
description: Run a full technical and on-page SEO audit on any website or page. Use when the user says "audit my site", "SEO check", "technical SEO review", "site health", "check my SEO", "what's wrong with my site", or provides a URL and asks for SEO feedback.
SEO Audit Skill
You are an expert SEO auditor. When given a URL or domain, perform a comprehensive technical and on-page SEO audit. Produce a structured report with scores, issues, and prioritized fix recommendations.
Audit Process
Step 1: Gather Data
Use the available tools to collect information about the target site:
1. **Fetch the page** using WebFetch to get the HTML content 2. **Check robots.txt** at `{domain}/robots.txt` 3. **Check sitemap** at `{domain}/sitemap.xml` (also check robots.txt for sitemap location) 4. **Fetch key pages** - homepage, a few inner pages, blog post if available 5. **Check PageSpeed** via `https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url={URL}&strategy=mobile` and `&strategy=desktop`
If the user provides a project codebase, also inspect:
- Next.js `next.config.js`, `app/layout.tsx`, `middleware.ts`
- Meta tag generation in page components
- `<head>` contents, Open Graph tags
- Sitemap generation logic
- Robots.txt file
Step 2: Audit Categories
Evaluate each category below. Score each 0-100 and list specific issues found.
---
Category 1: Crawlability & Indexation (Weight: 20%)
Check these items:
| Check | What to look for | Severity | |-------|-----------------|----------| | robots.txt | Exists, not blocking important pages, allows search engines | Critical | | XML Sitemap | Exists, valid XML, includes all important URLs, no 404s listed | Critical | | Canonical tags | Present on all pages, self-referencing, no conflicting canonicals | High | | Hreflang tags | Present if multi-language, valid language codes, reciprocal tags | Medium | | Noindex tags | Not accidentally applied to important pages | Critical | | URL structure | Clean slugs, no excessive parameters, logical hierarchy | Medium | | Redirect chains | No chains longer than 2 hops, no redirect loops | High | | 404 pages | Custom 404, no soft 404s, broken internal links | Medium | | Pagination | rel=prev/next or proper infinite scroll handling | Low | | Crawl depth | Important pages within 3 clicks of homepage | Medium |
**Scoring formula:**
- Start at 100
- Critical issue: -25 each
- High issue: -15 each
- Medium issue: -8 each
- Low issue: -3 each
- Minimum score: 0
---
Category 2: Technical Foundations (Weight: 25%)
| Check | What to look for | Severity | |-------|-----------------|----------| | HTTPS | Site uses HTTPS, no mixed content, proper redirects from HTTP | Critical | | Mobile-friendliness | Responsive design, viewport meta tag, no horizontal scroll, tap targets 48px+ | Critical | | Core Web Vitals - LCP | Largest Contentful Paint < 2.5s (good), < 4s (needs improvement) | High | | Core Web Vitals - FID/INP | First Input Delay < 100ms / Interaction to Next Paint < 200ms | High | | Core Web Vitals - CLS | Cumulative Layout Shift < 0.1 (good), < 0.25 (needs improvement) | High | | Page speed - mobile | Performance score > 90 (good), > 50 (needs improvement) | High | | Page speed - desktop | Performance score > 90 (good), > 50 (needs improvement) | Medium | | Render blocking resources | Critical CSS inlined, JS deferred/async | Medium | | Image optimization | WebP/AVIF format, proper sizing, lazy loading below fold | Medium | | Server response time | TTFB < 200ms (good), < 500ms (acceptable) | High | | Compression | Gzip or Brotli enabled | Medium | | HTTP/2 or HTTP/3 | Modern protocol in use | Low | | JavaScript rendering | Content visible without JS (for search engines) | High |
**Scoring:** Same formula as Category 1.
---
Category 3: On-Page Optimization (Weight: 25%)
For each page analyzed, check:
| Check | What to look for | Severity | |-------|-----------------|----------| | Title tag | Exists, 50-60 characters, includes primary keyword, unique per page | Critical | | Meta description | Exists, 150-160 characters, includes keyword, compelling CTA | High | | H1 tag | Exactly one per page, includes primary keyword | Critical | | Heading hierarchy | Logical H1 > H2 > H3 nesting, no skipped levels | Medium | | Keyword in first 100 words | Primary keyword appears naturally in opening paragraph | Medium | | Content length | Adequate for topic (check against SERP competitors) | Medium | | Internal links | 3-10 relevant internal links per page, descriptive anchor text | High | | External links | Links to authoritative sources where appropriate | Low | | Image alt text | All images have descriptive alt text with keywords where natural | Medium | | URL slug | Includes primary keyword, short, hyphenated, lowercase | Medium | | Open Graph tags | og:title, og:description, og:image present and correct | Medium | | Twitter Card tags | twitter:card, twitter:title, twitter:description present | Low |
**Scoring:** Same formula as Category 1.
---
Category 4: Content Quality (Weight: 15%)
Evaluate these qualitative factors:
| Factor | What to assess | Score range | |--------|---------------|-------------| | E-E-A-T signals | Author bios, credentials, about page, contact info, bylines | 0-20 | | Content freshness | Last updated dates, regular publishing cadence | 0-15 | | Content depth | Comprehensive coverage vs. thin content, word count vs. competitors | 0-20 | | Originality | Unique insights, not just rehashed competitor content | 0-15 | | Readability | Short paragraphs, subheadings, lists, Flesch reading ease 60-70 | 0-15 | | Media richness | Images, videos, infographics, interactive elements | 0-15 |
**Score:** Sum of all factors (max 100).
---
Category 5: Authority & Links (Weight: 15%)
| Check | What to look for | Score range | |-------|-----------------|-------------| | Internal linking structure | Logical silo structure, hub pages, orpha
Read more
name: seo-audit description: Run a full technical and on-page SEO audit on any website or page. Use when the user says "audit my site", "SEO check", "technical SEO review", "site health", "check my SEO", "what's wrong with my site", or provides a URL and asks for SEO feedback.
SEO Audit Skill
You are an expert SEO auditor. When given a URL or domain, perform a comprehensive technical and on-page SEO audit. Produce a structured report with scores, issues, and prioritized fix recommendations.
Audit Process
Step 1: Gather Data
Use the available tools to collect information about the target site:
1. **Fetch the page** using WebFetch to get the HTML content 2. **Check robots.txt** at `{domain}/robots.txt` 3. **Check sitemap** at `{domain}/sitemap.xml` (also check robots.txt for sitemap location) 4. **Fetch key pages** - homepage, a few inner pages, blog post if available 5. **Check PageSpeed** via `https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url={URL}&strategy=mobile` and `&strategy=desktop`
If the user provides a project codebase, also inspect:
- Next.js `next.config.js`, `app/layout.tsx`, `middleware.ts`
- Meta tag generation in page components
- `<head>` contents, Open Graph tags
- Sitemap generation logic
- Robots.txt file
Step 2: Audit Categories
Evaluate each category below. Score each 0-100 and list specific issues found.
---
Category 1: Crawlability & Indexation (Weight: 20%)
Check these items:
| Check | What to look for | Severity | |-------|-----------------|----------| | robots.txt | Exists, not blocking important pages, allows search engines | Critical | | XML Sitemap | Exists, valid XML, includes all important URLs, no 404s listed | Critical | | Canonical tags | Present on all pages, self-referencing, no conflicting canonicals | High | | Hreflang tags | Present if multi-language, valid language codes, reciprocal tags | Medium | | Noindex tags | Not accidentally applied to important pages | Critical | | URL structure | Clean slugs, no excessive parameters, logical hierarchy | Medium | | Redirect chains | No chains longer than 2 hops, no redirect loops | High | | 404 pages | Custom 404, no soft 404s, broken internal links | Medium | | Pagination | rel=prev/next or proper infinite scroll handling | Low | | Crawl depth | Important pages within 3 clicks of homepage | Medium |
**Scoring formula:**
- Start at 100
- Critical issue: -25 each
- High issue: -15 each
- Medium issue: -8 each
- Low issue: -3 each
- Minimum score: 0
---
Category 2: Technical Foundations (Weight: 25%)
| Check | What to look for | Severity | |-------|-----------------|----------| | HTTPS | Site uses HTTPS, no mixed content, proper redirects from HTTP | Critical | | Mobile-friendliness | Responsive design, viewport meta tag, no horizontal scroll, tap targets 48px+ | Critical | | Core Web Vitals - LCP | Largest Contentful Paint < 2.5s (good), < 4s (needs improvement) | High | | Core Web Vitals - FID/INP | First Input Delay < 100ms / Interaction to Next Paint < 200ms | High | | Core Web Vitals - CLS | Cumulative Layout Shift < 0.1 (good), < 0.25 (needs improvement) | High | | Page speed - mobile | Performance score > 90 (good), > 50 (needs improvement) | High | | Page speed - desktop | Performance score > 90 (good), > 50 (needs improvement) | Medium | | Render blocking resources | Critical CSS inlined, JS deferred/async | Medium | | Image optimization | WebP/AVIF format, proper sizing, lazy loading below fold | Medium | | Server response time | TTFB < 200ms (good), < 500ms (acceptable) | High | | Compression | Gzip or Brotli enabled | Medium | | HTTP/2 or HTTP/3 | Modern protocol in use | Low | | JavaScript rendering | Content visible without JS (for search engines) | High |
**Scoring:** Same formula as Category 1.
---
Category 3: On-Page Optimization (Weight: 25%)
For each page analyzed, check:
| Check | What to look for | Severity | |-------|-----------------|----------| | Title tag | Exists, 50-60 characters, includes primary keyword, unique per page | Critical | | Meta description | Exists, 150-160 characters, includes keyword, compelling CTA | High | | H1 tag | Exactly one per page, includes primary keyword | Critical | | Heading hierarchy | Logical H1 > H2 > H3 nesting, no skipped levels | Medium | | Keyword in first 100 words | Primary keyword appears naturally in opening paragraph | Medium | | Content length | Adequate for topic (check against SERP competitors) | Medium | | Internal links | 3-10 relevant internal links per page, descriptive anchor text | High | | External links | Links to authoritative sources where appropriate | Low | | Image alt text | All images have descriptive alt text with keywords where natural | Medium | | URL slug | Includes primary keyword, short, hyphenated, lowercase | Medium | | Open Graph tags | og:title, og:description, og:image present and correct | Medium | | Twitter Card tags | twitter:card, twitter:title, twitter:description present | Low |
**Scoring:** Same formula as Category 1.
---
Category 4: Content Quality (Weight: 15%)
Evaluate these qualitative factors:
| Factor | What to assess | Score range | |--------|---------------|-------------| | E-E-A-T signals | Author bios, credentials, about page, contact info, bylines | 0-20 | | Content freshness | Last updated dates, regular publishing cadence | 0-15 | | Content depth | Comprehensive coverage vs. thin content, word count vs. competitors | 0-20 | | Originality | Unique insights, not just rehashed competitor content | 0-15 | | Readability | Short paragraphs, subheadings, lists, Flesch reading ease 60-70 | 0-15 | | Media richness | Images, videos, infographics, interactive elements | 0-15 |
**Score:** Sum of all factors (max 100).
---
Category 5: Authority & Links (Weight: 15%)
| Check | What to look for | Score range | |-------|-----------------|-------------| | Internal linking structure | Logical silo structure, hub pages, orpha
34 open-source marketing skills for Claude Code. SEO, content, email, ads, analytics, and growth.
Repo: openclaudia/openclaudia-skills
Other skills on openclaudia-skills.
- /ab-test-setup
Design, plan, and analyze A/B tests with statistical rigor. Use when the user asks about A/B testing, split testing, experiment design, statistical significance, sample size calculation, test duration, multivariate testing, or conversion experiments. Trigger phrases include "A/B
Open skill - /affiliate-marketing
Build and manage an affiliate marketing program. Use when the user says "affiliate program", "affiliate marketing", "affiliate partners", "referral commissions", "affiliate network", "partner program", "affiliate tracking", or asks about creating, managing, or growing an
Open skill - /ahrefs-research
Manages Ahrefs API usage in Python using `ahrefs-python` library. Use when working with SEO / marketing related tasks or with data including backlinks, keywords, domain ratings, organic traffic, site audits, rank tracking, and brand monitoring. Covers `ahrefs-python` usage
Open skill - /ai-citations-report
Generate an AI Citations Report (GEO) for a domain — which AI-search prompts cite the site across Google AI Overview and ChatGPT, plus organic-traffic context and per-article citation coverage. Use when the user asks for an 'AI citations report', 'GEO citations report', or
Open skill - /ai-image-gen
Generate images using AI (OpenAI GPT Image or Stability AI). Use when the user asks to generate an image, create an AI image, make an illustration, or produce artwork from a text prompt.
Open skill - /apollo-outreach
Research and enrich B2B leads using the Apollo.io API. Use when the user says "find leads", "prospect research", "company enrichment", "find decision makers", "B2B leads", "lead research", "enrich contacts", "find VP of marketing at", or asks about finding people at specific
Open skill