Seo Auditor

Description

| Scan and optimize documentation files for SEO. Audits README.md files and docs/ pages for meta tags, headings, keywords, readability, duplicate content, and broken links. Applies fixes, updates sitemap.xml, and generates a report. Usage: /seo-auditor [path]

What this skill does

1. 1Scans all docs/ and README.md files, classifies them by type (skill pages, index pages, static pages), and captures a baseline of current SEO state.
2. 2Audits and auto-fixes meta titles and descriptions — enforcing length limits, keyword presence, and uniqueness across all pages.
3. 3Runs readability scoring, heading hierarchy checks, and AI content detection, applying fixes to recently modified pages while preserving high-ranking content.
4. 4Validates keyword placement in titles, descriptions, H1s, first paragraphs, and H2 subheadings, and flags keyword stuffing above 3% density.
5. 5Checks all internal links for broken paths, detects orphan pages not referenced in navigation, and regenerates the sitemap via an MkDocs build.

When to use

• You maintain a documentation site and want a systematic SEO pass across all markdown files without touching high-ranking pages.
• Meta descriptions are missing, duplicated, or too long across many pages and you want auto-fixes applied at scale.
• Internal links are broken after a docs restructure and you need them audited and corrected.
• You want to confirm that programmatically generated skill or agent pages meet SEO standards before publishing.

Tools used

Frequently asked questions