Skip to content
All skillsQuality

Check skill

AI Legibility Audit

draft, under review4 phases2 bundled files

Is your site legible to AI, the part you can actually verify? It checks server-rendered content, valid JSON-LD, a clean markdown mirror, a well-formed llms.txt, and AI-crawler robots rules. It grades your site's own bytes, never promises a ranking, because that part is a black box.

Install
/plugin marketplace add Selwynuy/selwynuy
/plugin install selwyn-handbook@selwyn-handbook
# then run: /selwyn-handbook:ai-legibility-audit

Or read it as SKILL.md.

When it activates

Use this skill when before launch, or when adding AI-facing surfaces (llms.txt, markdown endpoints, structured data), to check a site is machine-legible.

The workflow

  1. Fetch

    Curl each key route with JavaScript off (the raw HTML a non-JS crawler sees) and confirm the real content, the JSON-LD, the single h1, and the article structure are all present in the initial bytes, not injected after hydration.

    seo

  2. Structure

    Confirm exactly one h1 and a non-skipping heading hierarchy, semantic article/nav landmarks, descriptive link text and alt attributes, valid JSON-LD whose fields match the visible content, and dateModified consistent with the sitemap lastmod and the visible date.

    seo

  3. AI surfaces

    Confirm the machine-readable surfaces are present and well-formed: a clean per-page markdown endpoint that mirrors the HTML, an llms.txt in the H1 to blockquote to H2 shape, an AGENTS.md at the repo root, and a robots.txt that names real AI user-agents (GPTBot, ClaudeBot, PerplexityBot, Google-Extended) with the intended allow or disallow.

    how-to-use

  4. Report honestly

    Report each surface as present, valid, or missing with the byte-level evidence and the standard it was checked against. State plainly that these verify legibility, not ranking or citation, which depend on opaque engines outside the site. Do not turn any unproven GEO tactic into an action item.

    writing-without-ai-slop

What ships in the bundle

  • scriptscripts/scan-ai-legibility.mjsFetches routes and checks the mechanical AI-legibility surfaces (server-rendered content, one h1, JSON-LD, markdown endpoint, llms.txt shape, AI-crawler robots rules), reporting presence and validity only.
  • referencereferences/ai-legibility-checklist.mdEvery checkable surface with its verification and the published standard behind it, plus a dated, hedged note on what GEO research suggests and why this skill does not automate it.

1 run, the rest load on demand.