Slash Command17.9k repo starsupdated yesterday

seo-auditor

This Claude Code slash command performs comprehensive SEO audits of documentation files across meta tags, content quality, keyword optimization, and link integrity. It scans markdown files in the docs directory and README files, extracting and validating title tags (50-60 characters), meta descriptions (120-160 characters), heading structure, keyword placement, and internal links. The tool auto-fixes non-destructive issues like generic titles and broken links while preserving high-ranking content, and can operate in report-only mode to identify issues without making changes. Use this when publishing new documentation, updating existing pages, or conducting site-wide SEO optimization to ensure consistency and search engine visibility.

View source Repository: claude-skills

Install in Claude Code

Copy

mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/alirezarezvani/claude-skills/HEAD/.claude/commands/seo-auditor.md -o ~/.claude/commands/seo-auditor.md

Then start a new Claude Code session; the slash command loads automatically.

Definition

seo-auditor.md

Run the SEO auditor on documentation files. Target path: `$ARGUMENTS` (default: all docs/ and root README.md).

If `$ARGUMENTS` is `--report-only`, scan without making changes.

Execute all 7 phases. Auto-fix non-destructive issues. Never change URLs. Preserve content on high-ranking pages.

## Phase 1: Discovery

Find all target markdown files:
- `docs/**/*.md` — all documentation pages
- `README.md` files in domain root directories
- If `$ARGUMENTS` specifies a path, scope to that path only

For each file, extract current state: `title:` frontmatter, `description:` frontmatter, H1, H2s, word count, link count. Store as baseline for the report.

Identify recently changed files: `git log --oneline -2 --name-only -- docs/ README.md`

## Phase 2: Meta Tags

For each file with YAML frontmatter:

**Title** (`title:` field):
- Must be 50-60 characters
- Must contain a primary keyword
- Must be unique across all pages
- Auto-fix generic titles using domain context

**Description** (`description:` field):
- Must be 120-160 characters
- Must contain primary keyword
- Must be unique — no duplicates
- Auto-fix from SKILL.md frontmatter or first paragraph

Run SEO checker on built HTML pages:
```bash
python3 marketing-skill/seo-audit/scripts/seo_checker.py --file site/{path}/index.html
```

## Phase 3: Content Quality

**Heading structure:** One H1 per page, no skipped levels, keywords in headings.

**Readability:** Run content scorer:
```bash
python3 marketing-skill/content-production/scripts/content_scorer.py {file}
```
Target: readability ≥ 70, structure ≥ 60.

**AI detection** (on non-generated files only):
```bash
python3 marketing-skill/content-humanizer/scripts/humanizer_scorer.py {file}
```
Flag pages < 50. Fix AI clichés: "delve", "leverage", "it's important to note", "comprehensive".

**Do NOT rewrite** pages ranking well — only fix critical issues on those.

## Phase 4: Keywords

Check each page has its primary keyword in: title, description, H1, first paragraph, at least one H2.

Keyword density: 1-2% for primary. Flag and reduce if > 3%.

**Never change existing URLs.** Only optimize content and meta tags.

## Phase 5: Links

**Internal links:** Verify all `[text](url)` targets exist. Fix broken links.

**Duplicate content:**
```bash
grep -rh '^description:' docs/**/*.md | sort | uniq -d
```
Make each duplicate unique.

**Orphan pages:** Find pages not in `mkdocs.yml` nav. Add them.

## Phase 6: Sitemap

Rebuild the site to regenerate sitemap:
```bash
mkdocs build
```

Analyze the sitemap:
```bash
python3 marketing-skill/site-architecture/scripts/sitemap_analyzer.py site/sitemap.xml
```

Verify all pages appear, no duplicates, no broken URLs.

## Phase 7: Report

Present a summary showing: pages scanned, issues found, auto-fixes applied, manual review items, broken links fixed, orphans resolved, sitemap URL count. List preserved pages that were not modified.