SEO Site Audit
Transform website-level SEO into an engineering-executable task backlog.
Outputs
- Executive Summary — Top findings with P0/P1/P2 priorities
- Assumptions & Inputs — What URLs/templates were analyzed
- Findings by Theme — Organized P0→P1→P2 with example URLs
- Engineering Backlog — Actionable task table (see templates/site-backlog-template.md)
- Implementation Notes — Where fixes should land (layout, route, middleware, CMS, build)
- Validation & Rollout Plan — Pre-launch checks and 7-day monitoring
When to Use
- "Audit my website for SEO"
- "Technical SEO review"
- "Site-wide audit / improve indexing"
- Mentions: robots.txt, sitemap, canonical, redirects, 404s, soft 404s
- Mentions: meta tags, Open Graph, Twitter cards, JSON-LD structured data
- Mentions: internal linking, information architecture, hub-pillar, orphan pages
- Mentions: Core Web Vitals, performance, mobile, accessibility
Not Applicable (Use seo-article-optimizer Instead)
- Single article or landing page content optimization (keywords, readability, meta/slug)
Required Inputs
- Site type: SaaS / Content site / E-commerce / Documentation / Other
- Tech stack: Next.js / Nuxt / WordPress / Webflow / Static / Other
- Target language & region: zh-CN/en/multilingual; hreflang needed?
- URL samples (at least one of):
- sitemap.xml
- Route list / exported URL list
- Key site pages (>= 10 URLs)
- Business goal: Lead gen (signup/demo/trial) / E-commerce / Brand awareness; plus 1-3 most important conversion page URLs
If user cannot provide URL list or sitemap: Only deliver "principle-based recommendations + required information checklist". Do NOT pretend to complete an audit.
Priority Levels
- P0 (Critical): Blocks indexing or causes major SEO damage
- P1 (High): Significant impact on rankings or user experience
- P2 (Medium): Optimization opportunities for improvement
Common P0 Issues (Development Environment Leaks)
These often survive from dev/staging to production:
| Issue |
Where to Check |
noindex, nofollow meta tag |
<head> section |
| robots.txt blocking all crawlers |
/robots.txt |
| Staging URLs in sitemap |
sitemap.xml |
| Debug/preview modes enabled |
CMS settings, env vars |
Quality Gates
- No vague advice (e.g., "improve meta") — must give specific fix + validation method
- No assumptions about sitemap/robots/schema existence without verification
- Must produce actionable backlog with priority ranking
Workflow
For detailed audit methodology, see workflow.md.
Summary:
- Build Page Type Model (bucket by template/page type)
- P0: Indexability & Canonicalization
- P1: Site-level Meta & Share Assets (Meta/OG/Twitter)
- P1: Structured Data (JSON-LD / schema.org)
- P1: Information Architecture & Internal Linking
- P2: Performance, Mobile, Accessibility
Troubleshooting
| Issue |
Solution |
| Cannot access site |
Ask user to provide HTML source or exported data |
| No sitemap available |
Request URL list or route export |
| Missing required inputs |
List specific missing items before proceeding |
| Site behind authentication |
Ask for public pages or static exports |
Supporting Files
For detailed information, read these files when needed:
- Detailed workflow steps: workflow.md
- Implementation snippets & reference: reference.md
- Output templates: See templates/
1---2name: seo-site-audit3description: Website-level technical SEO audit with engineering backlog. Covers robots.txt, sitemap, canonical, redirects, meta/OG/Twitter, JSON-LD, internal linking, Core Web Vitals, mobile. Use for site-wide SEO improvements or technical SEO implementation.4---56# SEO Site Audit78Transform website-level SEO into an engineering-executable task backlog.910## Outputs11121. **Executive Summary** — Top findings with P0/P1/P2 priorities132. **Assumptions & Inputs** — What URLs/templates were analyzed143. **Findings by Theme** — Organized P0→P1→P2 with example URLs154. **Engineering Backlog** — Actionable task table (see templates/site-backlog-template.md)165. **Implementation Notes** — Where fixes should land (layout, route, middleware, CMS, build)176. **Validation & Rollout Plan** — Pre-launch checks and 7-day monitoring1819## When to Use2021- "Audit my website for SEO"22- "Technical SEO review"23- "Site-wide audit / improve indexing"24- Mentions: robots.txt, sitemap, canonical, redirects, 404s, soft 404s25- Mentions: meta tags, Open Graph, Twitter cards, JSON-LD structured data26- Mentions: internal linking, information architecture, hub-pillar, orphan pages27- Mentions: Core Web Vitals, performance, mobile, accessibility2829## Not Applicable (Use seo-article-optimizer Instead)3031- Single article or landing page content optimization (keywords, readability, meta/slug)3233## Required Inputs34351. **Site type**: SaaS / Content site / E-commerce / Documentation / Other362. **Tech stack**: Next.js / Nuxt / WordPress / Webflow / Static / Other373. **Target language & region**: zh-CN/en/multilingual; hreflang needed?384. **URL samples** (at least one of):39 - sitemap.xml40 - Route list / exported URL list41 - Key site pages (>= 10 URLs)425. **Business goal**: Lead gen (signup/demo/trial) / E-commerce / Brand awareness; plus 1-3 most important conversion page URLs4344> **If user cannot provide URL list or sitemap**: Only deliver "principle-based recommendations + required information checklist". Do NOT pretend to complete an audit.4546## Priority Levels4748- **P0 (Critical)**: Blocks indexing or causes major SEO damage49- **P1 (High)**: Significant impact on rankings or user experience50- **P2 (Medium)**: Optimization opportunities for improvement5152## Common P0 Issues (Development Environment Leaks)5354These often survive from dev/staging to production:5556| Issue | Where to Check |57| -------------------------------- | ---------------------- |58| `noindex, nofollow` meta tag | `<head>` section |59| robots.txt blocking all crawlers | `/robots.txt` |60| Staging URLs in sitemap | `sitemap.xml` |61| Debug/preview modes enabled | CMS settings, env vars |6263## Quality Gates6465- No vague advice (e.g., "improve meta") — must give specific fix + validation method66- No assumptions about sitemap/robots/schema existence without verification67- Must produce actionable backlog with priority ranking6869## Workflow7071For detailed audit methodology, see [workflow.md](workflow.md).7273**Summary**:74751. Build Page Type Model (bucket by template/page type)762. P0: Indexability & Canonicalization773. P1: Site-level Meta & Share Assets (Meta/OG/Twitter)784. P1: Structured Data (JSON-LD / schema.org)795. P1: Information Architecture & Internal Linking806. P2: Performance, Mobile, Accessibility8182## Troubleshooting8384| Issue | Solution |85| -------------------------- | ------------------------------------------------ |86| Cannot access site | Ask user to provide HTML source or exported data |87| No sitemap available | Request URL list or route export |88| Missing required inputs | List specific missing items before proceeding |89| Site behind authentication | Ask for public pages or static exports |9091## Supporting Files9293For detailed information, read these files when needed:9495- **Detailed workflow steps**: [workflow.md](workflow.md)96- **Implementation snippets & reference**: [reference.md](reference.md)97- **Output templates**: See templates/
bolasblack