audit-static-site

name	audit-static-site
description	Use to crawl a built static-site output dir and flag SEO/UX issues (titles, meta descriptions, alt text, thin/orphan/duplicate pages) before publishing. Triggers "audit the site", "SEO check", "check the build for SEO". Generic to any static site whose output is plain HTML.

Audit a built static site

Run after a production build, before publishing — or as a gate in an improvement loop (--check exits non-zero on any ERROR).

Workflow

Run the vendored script against the built output:

python3 <skill-dir>/site-audit.py \
  --public public \
  --site-suffix " | My Site" \
  --sections posts,talks \
  --out docs/audit/<date>.md

• --public built output dir (default public).
• --site-suffix the trailing site-name string appended to every <title>, stripped before length checks.
• --sections comma-separated content section dirs to audit.
• --check exit 1 on any ERROR — use in CI / loops.
• --min-words thin-content threshold (default 300).

It flags over/under-length titles & descriptions, missing meta description, images without alt text, thin pages, orphan pages, and duplicate titles/descriptions.

Guardrails

• Reads the BUILT output, not content/ — rebuild first.
• Defaults are generic SEO ranges; override per project rather than hardcoding.

Output

A markdown report grouped by severity (or --check for a CI exit code).