Skip to content

v2.4.1 — ai-geo llms.txt discoverability signals

Choose a tag to compare

@charlesjones-dev charlesjones-dev released this 18 Apr 04:35
· 1 commit to main since this release

ai-geo v1.0.0 → v1.1.0

Extends all three ai-geo skills with the stackable weak-signal stack for llms.txt discovery beyond serving /llms.txt at root.

🧪 No major LLM provider (OpenAI, Anthropic, Perplexity, Google) has publicly committed to reading llms.txt as a first-class signal. Discovery today depends on multiple weak signals stacked together.

Changed

/geo-audit

  • Category 1 (llms.txt Protocol Compliance) gains four discoverability-signal checks:
    • <head> <link rel="alternate" type="text/markdown" title="llms.txt" href="/llms.txt">Medium if missing
    • sitemap.xml <url><loc>/llms.txt</loc></url> entry — Medium if missing
    • robots.txt # LLM index: https://<domain>/llms.txt comment — Low / informational
    • Public directory submission (llmstxt.site, directory.llmstxt.cloud) — Low / manual; never auto-detected, never Critical/High
  • Report template gains "On llms.txt discovery" subsection documenting the weak-signal landscape and 🧪 experimental marker.

/geo-fix

  • Safe-auto bucket gains three new fixes:
    • <link rel="alternate"> in <head> via framework-idiomatic head API (Next.js Metadata API alternates.types, Nuxt useHead, Vue + @unhead/vue, Astro layout, SvelteKit <svelte:head>, Remix meta export, vanilla <head>) — skip if already present
    • /llms.txt entry in sitemap (Next.js app/sitemap.ts push, static <url> block with changefreq=monthly + priority=0.5, @nuxtjs/sitemap, @astrojs/sitemap customPages) — skip if already present
    • # LLM index: https://<domain>/llms.txt comment in robots.txt with auto-derived domain (prompts if unresolvable) — skip if already present
  • New informational bucket prints directory-submission URLs as a manual next step (web forms, never automated).
  • Terminal summary gains "llms.txt discovery signals" block with per-signal status + build-order warning.
  • Build-order rule: when both llms.txt and sitemap are build-time generated, llms.txt generator MUST run first so the sitemap can read llms.txt's mtime. Warn with suggested reordering rather than silent reshuffle.

/geo-llms-txt

  • New Step 7.5 — Wire Discoverability Signals (post-write) offers to add the head link[rel=alternate] hint, sitemap /llms.txt entry, and robots.txt comment after writing llms.txt, each skipped if already present.
  • New Build pipeline — order dependency subsection under Step 6 documents per-framework rules: Next.js Metadata API (no order issue), Astro endpoint vs static, Nuxt prebuild hook, Vite/SvelteKit/Remix/TanStack Start warn-don't-reshuffle.
  • Terminal summary gains discoverability-signal statuses + manual directory-submission URLs.
  • Quality Assurance Checklist extended with post-write wiring + build-order + directory-submission items.
  • llms-full.txt logic unchanged.

Preserved

LLM Knowledge Gap Corrections, examples, and existing QA checklist items across all three skills.

Marketplace

  • ai-geo: 1.0.01.1.0
  • marketplace: 2.4.02.4.1

Full changelog: v2.4.0...v2.4.1