agent-discovery

Installation
SKILL.md

Agent Discovery

This skill is about an opinionated blend of traditional SEO, static truth in the initial response, and UX ergonomics for agents and operators.

Don't reduce this to "AI SEO".

If a page can't be crawled, cited, parsed, navigated, or actioned by an agent harness, it is broken in a way normal SEO reports won't fully show.

Thesis

Treat agent discoverability as four stacked layers:

  1. Search baseline — crawlable pages, clean robots policy, sitemap, structured data, canonical answers, freshness.
  2. Initial-response truth — the important facts must be present in the first HTML response.
  3. Machine-readable projections — markdown/text/JSON surfaces that project the same canonical resource without drift.
  4. Operator ergonomics — the site should be easy to drive from pi, OpenCode, Claude Code, ChatGPT, or a browser agent without guesswork.
Installs
4
GitHub Stars
57
First Seen
Mar 18, 2026
agent-discovery — joelhooks/joelclaw