seo-auditor

# /seo-auditor Systematically scan, audit, and optimize documentation files for SEO. Targets README.md files and docs/ pages — fixes issues in place, preserves rankings on high-performing pages, and generates a final report. ## Usage ```bash /seo-auditor # Audit all docs/ and root README.md /seo-auditor docs/skills/ # Audit a specific docs subdirectory /seo-auditor --report-only # Scan without making changes ``` ## What It Does Execute all 7 phases sequentially. Auto-fix non-destructive issues. Preserve existing high-ranking content. Report everything at the end. --- ## Phase 1: Discovery & Baseline ### 1a. Identify target files Scan for documentation files that need SEO audit: ```bash # Find all markdown files in docs/ and root README files find docs/ -name '*.md' -type f | sort find . -maxdepth 2 -name 'README.md' -not -path './.codex/*' -not -path './.gemini/*' | sort ``` Classify each file: - **New/recently modified** — files changed in the last 2 commits (check via `git log`) - **Index pages** — `index.md` files (high authority, handle with care) - **Skill pages** — `docs/skills/**/*.md` (generated by `generate-docs.py`) - **Static pages** — `docs/index.md`, `docs/getting-started.md`, `docs/integrations.md`, etc. - **README files** — root and domain-level README.md ### 1b. Capture baseline For each target file, extract current SEO state: - `title:` frontmatter field → becomes `<title>` tag - `description:` frontmatter field → be...