technical seo audit

Search engines cannot index what they cannot understand. When your site is technically broken, no amount of content strategy or backlinking will save your rankings. This skill identifies the invisible technical hurdles—from broken canonical tags to malformed JSON-LD—that prevent search engines from crawling and ranking your pages effectively.

What it does

• Live & Local Audits analyzes production URLs or local source code to find indexing and metadata errors.
• Framework-Specific Fixes generates precise implementation code for Next.js, WordPress, React SPAs, and Static Site Generators.
• Priority Reporting categorizes findings into Critical, Important, and Polish tiers based on search impact.
• Schema & Metadata Validation checks Open Graph, Twitter Cards, and JSON-LD structured data for rich snippet eligibility.
• Infrastructure Verification audits robots.txt, XML sitemaps, HTTPS redirects, and Core Web Vitals red flags.

How it works

1. Target Identification analyzes the project stack and determines if the audit should target a live URL or the local filesystem.
2. Audit Execution runs an internal Python diagnostic or local checklist to detect configuration errors across 15+ SEO signals.
3. Strategic Reporting delivers a prioritized markdown report explaining the "why" behind every technical failure.
4. Automated Implementation applies code-level fixes directly to your templates, layouts, or configuration files.

Frameworks & tools

Uses a Python-based diagnostic suite for live site scanning. Supports technical implementations for Next.js (App and Pages router), WordPress (functions.php and plugin hooks), React/Vite SPAs, and SSGs like Astro, Hugo, and Eleventy.

Why this beats prompting it yourself

Generic LLMs often confuse SEO best practices across different frameworks, suggesting Next.js fixes for Vite projects or ignoring the nuances of the Next.js App Router metadata API. This skill uses framework-specific reference files and a dedicated Python diagnostic script to ensure recommendations are technically accurate and actually implementable in your specific environment.

Use cases

• Auditing a new deployment to ensure noindex tags were removed after staging.
• Implementing JSON-LD structured data to capture Google rich snippets.
• Fixing "page not found" or crawling errors in a Next.js or React application.
• Restructuring heading hierarchies and image alt tags to meet accessibility and SEO standards.

Known limitations

Does not perform keyword research, competitor analysis, or backlink auditing. Implementation in React SPAs is limited by what search engines can crawl without SSR/SSG.