Skip to content

Add agent visibility: llms.txt + HTML fallback + JSON-LD#8

Merged
hrhrng merged 1 commit into
mainfrom
worktree-agent-visibility
Mar 14, 2026
Merged

Add agent visibility: llms.txt + HTML fallback + JSON-LD#8
hrhrng merged 1 commit into
mainfrom
worktree-agent-visibility

Conversation

@hrhrng
Copy link
Copy Markdown
Owner

@hrhrng hrhrng commented Mar 14, 2026

Summary

  • Add /llms.txt and /llms-full.txt following the llmstxt.org standard — AI agents can fetch these to understand the site and its URL API
  • Add #agent-info HTML block in index.html — visible to WebFetch/crawlers, auto-hidden when React mounts via #root:not(:empty) ~ #agent-info
  • Add JSON-LD structured data and meta description for search engines
  • Add <link rel="help"> pointing to /llms.txt for discoverability

Three layers of agent visibility

Layer Path Purpose
llms.txt /llms.txt Standard LLM site docs — concise overview + URL API
llms-full.txt /llms-full.txt Full documentation: all view modes, examples, skill install
HTML fallback index.html #agent-info SPA fallback — WebFetch sees content directly in HTML

Test plan

  • npm run build succeeds, llms.txt and llms-full.txt present in dist/
  • Visit site in browser — React app loads normally, #agent-info is hidden
  • Fetch /llms.txt directly — returns readable Markdown with URL API docs
  • Disable JS in browser — #agent-info content is visible

…ed data

Make the site discoverable and usable by AI agents via three layers:
- /llms.txt and /llms-full.txt (standard LLM site documentation)
- HTML #agent-info block (visible to WebFetch, hidden when React mounts)
- JSON-LD structured data and meta description
@hrhrng hrhrng merged commit 60d4014 into main Mar 14, 2026
6 of 7 checks passed
@hrhrng hrhrng deleted the worktree-agent-visibility branch March 14, 2026 13:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant