npx skills add ...
npx skills add calm-north/seojuice-skills --skill 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.
npx skills add calm-north/seojuice-skills --skill audit
Run a comprehensive SEO audit covering technical foundations, on-page optimization, content quality, link profile, and competitive positioning.
Gather this context (ask if not provided):
A complete SEO audit covers five layers. Work through them in order — problems in earlier layers undermine everything that follows.
Check whether search engines can properly access, crawl, render, and index the site.
robots.txt — fetch and review. No critical paths blocked? Sitemap directive present?noindex tags — any important pages accidentally noindexed?Check whether individual pages are properly optimized for their target keywords.
<title>alt attributesalt=""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 |
Evaluate whether the content deserves to rank.
Assess the site's backlink authority and quality.
Understand where the site stands relative to competitors.
After completing all layers, assign a health score:
| Layer | Weight | Score (1-10) | Weighted |
|---|---|---|---|
| Technical Foundation | 25% | [score] | [weighted] |
| On-Page Optimization | 20% | [score] | [weighted] |
| Content Quality | 25% | [score] | [weighted] |
| Link Profile | 15% | [score] | [weighted] |
| Competitive Position | 15% | [score] | [weighted] |
| Overall | 100% | [total] |
Scoring guide:
These conditions cap the overall score regardless of how well other layers perform. A single veto prevents a site from appearing healthy when it has a fatal flaw:
| Condition | Cap | Rationale |
|---|---|---|
robots.txt blocks all of Googlebot or blocks / | Overall capped at 1/10 | Nothing else matters if Google can't crawl |
> 20% of important pages have noindex accidentally | Overall capped at 3/10 | Most of the site is invisible to search |
| All three Core Web Vitals are "Poor" | Technical capped at 3/10 | Google deprioritizes sites with terrible UX |
| Zero external backlinks (entire domain) | Link Profile capped at 2/10 | No external authority signal exists |
| Site serves HTTP without redirect to HTTPS | Technical capped at 4/10 | Google requires HTTPS for trust signals |
| Google manual action active | Overall capped at 2/10 | Penalty overrides all optimization |
Check veto conditions before scoring layers. If any veto fires, flag it prominently in the executive summary and cap the relevant score.
Overall Health Score: [score]/10
Executive Summary 3-5 sentences covering: the site's biggest strength, the most critical issue, and the highest-impact opportunity.
Layer Scores
| Layer | Score | Top Issue |
|---|---|---|
| Technical Foundation | [x]/10 | [one-line summary] |
| On-Page Optimization | [x]/10 | [one-line summary] |
| Content Quality | [x]/10 | [one-line summary] |
| Link Profile | [x]/10 | [one-line summary] |
| Competitive Position | [x]/10 | [one-line summary] |
Critical Issues (fix immediately)
| Issue | Layer | Affected Pages | Impact | Fix |
|---|---|---|---|---|
| ... | ... | ... | high | ... |
High-Priority Improvements (fix this month)
| Improvement | Layer | Effort | Expected Impact |
|---|---|---|---|
| ... | ... | low/medium/high | ... |
Opportunities (plan for next quarter)
| Opportunity | Layer | Description |
|---|---|---|
| ... | ... | ... |
Detailed Findings [Full findings organized by layer with specific evidence and recommendations]
Month 1: Fix the foundation
Month 2: Strengthen content
Month 3: Build authority
Pro Tip: Try the free SEO Audit and Domain Authority Checker at seojuice.com for a quick automated baseline. For ongoing monitoring, SEOJuice MCP users can run
/seojuice:seo-overviewfor live health scores with trends,/seojuice:site-healthfor technical topology, and/seojuice:competitor-analysisfor competitive gaps.