The SEO Audit skill performs a structured technical, on-page, and content audit of a website to identify issues and provide actionable recommendations for improving organic search performance. It produces a detailed audit report with an executive summary, prioritized findings, and an action plan.

✨ What it does

  • Walks through three audit layers: technical, on-page, and content.
  • Uses two scripts: seo_checker.py for single-page scoring and seo_health_scorer.py for a weighted site health score.
  • Provides Core Web Vitals thresholds (LCP, INP, CLS) for performance assessment.
  • Outputs findings in a consistent Issue/Impact/Evidence/Fix/Priority format.
  • Generates a prioritized action plan grouped into critical, high-impact, quick wins, and long-term.
  • Includes a keyword cannibalization map as an output artifact.

🎯 When to use it

  • When the user asks for an SEO audit, technical SEO review, or 'why am I not ranking'.
  • When the user mentions SEO issues, on-page SEO, meta tags review, or SEO health check.
  • When organic traffic has dropped or rankings have fallen.
  • When planning or after a site migration, redesign, or new product launch.

🚀 How to use

Trigger the skill by asking for an SEO audit, technical SEO review, or mentioning SEO issues. The skill first checks for a product marketing context file and may ask clarifying questions about site type, goals, scope, and access to tools. It then runs the audit using provided scripts and produces a structured report. Example prompts:

Run an SEO audit on our SaaS site, focusing on the pricing and blog pages.
Why is my page not ranking? Please do an SEO health check.

📄 Output: A structured SEO audit report including executive summary, technical/on-page/content findings, prioritized action plan, and optional keyword cannibalization map.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/marketing-skill/skills/seo-audit .claude/skills/seo-audit

Skill source: marketing-skill/skills/seo-audit/SKILL.md

⚠️ Good to know

Requires access to the site's HTML files or URLs and optionally Google Search Console for full analysis; the skill provides scripts but does not automatically crawl the entire site.

❓ FAQ

What tools does the SEO audit use?

It uses two Python scripts: seo_checker.py for scoring individual pages and seo_health_scorer.py for a site-wide health score, plus free tools like Google Search Console and PageSpeed Insights.

What is the output format of the audit?

The output is a structured report with an executive summary, findings in Issue/Impact/Evidence/Fix/Priority format, and a prioritized action plan.

Can the audit be used for a full site or just specific pages?

The scope is flexible; you can specify a full site audit or focus on specific pages, and it can cover technical, on-page, or content aspects.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.