intermediate analytics Editor's Pick

SEO Content Audit

Scan your entire content directory, analyze each page for on-page SEO issues, and generate a prioritized fix report — all from the terminal using Claude Code.

Works with: claude-code
View source

Audit your website’s content for SEO issues directly from your codebase using Claude Code. This skill reads your actual source files — HTML, Markdown, MDX, Astro — checks meta tags, heading hierarchy, content length, and internal linking, then writes a prioritized report to your project.

What Makes This a Claude Code Skill

This leverages Claude Code’s ability to read your entire codebase, run shell commands, and write files. It scans actual source files rather than relying on a crawler.

Based on the real seo-audit skill from coreyhaines31/marketingskills and the /analyze-existing command from TheCraigHewitt/seomachine.

Setup

Create the file .claude/commands/seo-audit.md in your project root:

mkdir -p .claude/commands

Then add this content to .claude/commands/seo-audit.md:

Scan the project's content directory for SEO issues across all pages.

## Steps

1. Use Glob to find all content files (*.md, *.mdx, *.astro, *.html) in src/content/ and src/pages/
2. For each content file, analyze:
   - **Title tag**: Present? Under 60 characters? Contains target keyword?
   - **Meta description**: Present? Between 150-160 characters?
   - **Heading hierarchy**: H1 present and unique? Logical H2/H3 nesting?
   - **Content length**: Word count (flag pages under 300 words)
   - **Image alt text**: All images have descriptive alt attributes?
   - **Internal links**: Does the page link to at least 2 other pages?
   - **URL/slug**: Clean, lowercase, keyword-relevant?
3. Run `wc -w` on content files for accurate word counts
4. Check for duplicate title tags or meta descriptions
5. Write the full audit report to `./seo-audit-report.md` with:
   - Health score out of 100
   - Critical issues (must fix)
   - Warnings (should fix)
   - Opportunities (nice to have)
   - Per-page breakdown table
6. Print a summary to the terminal

Prioritize: missing titles > duplicate titles > thin content > missing alt text > missing internal links.

Usage

/project:seo-audit

Claude scans your codebase, analyzes every content page, and writes a detailed report to seo-audit-report.md.

Tips

  • Run after adding new content or before a site launch
  • Add seo-audit-report.md to .gitignore
  • Pair with the Content Calendar Builder skill for a full content strategy workflow