Add multi-layer agent discovery metadata to veralang.dev#412
Conversation
Four layers of machine-readable hints so agents can find SKILL.md without visual parsing, following priority order from #400: 1. <head> link elements - rel="alternate" type="text/markdown" href=SKILL.md (standard HTML) - rel="llms-txt" and rel="llms-full-txt" (Mintlify convention) 2. <script type="text/llms.txt"> inline block (Vercel convention) Invisible to browsers; immediately discoverable by DOM-parsing agents. Lists SKILL.md, AGENTS.md, llms.txt, llms-full.txt with descriptions. 3. HTTP headers — skipped; GitHub Pages does not support custom headers. 4. JSON-LD structured data Two new TechArticle entries in the existing @graph: SKILL.md and AGENTS.md, each with encodingFormat, audience, and isPartOf. 5. CTA button semantic attributes rel="agent-instructions", type="text/markdown", data-agent-role, data-agent-description on the existing "For Agents → SKILL.md" anchor. Co-Authored-By: Claude <noreply@anthropic.invalid>
|
Important Review skippedReview was skipped due to path filters ⛔ Files ignored due to path filters (1)
CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #412 +/- ##
=======================================
Coverage 90.30% 90.30%
=======================================
Files 49 49
Lines 19105 19105
Branches 220 220
=======================================
Hits 17253 17253
Misses 1848 1848
Partials 4 4
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
Closes #400.
Agents don't press buttons — they discover resources through
<head>metadata, structured data, and well-known conventions. This PR adds four layers of machine-readable hints so agents visiting veralang.dev can findSKILL.mdwithout visual parsing.Changes (priority order from #400)
1.
<head>link elementsrel="alternate" type="text/markdown" href=SKILL.md— standard HTML, broad compatibilityrel="llms-txt"andrel="llms-full-txt"— Mintlify convention, gaining adoption2.
<script type="text/llms.txt">inline blockInvisible to browsers (unrecognised MIME type → no execution). Immediately discoverable by any agent parsing the DOM for agent-directed content. No separate fetch required. Follows Vercel's proposal.
3. HTTP headers
Skipped — GitHub Pages does not support custom response headers.
4. JSON-LD structured data
Two new
TechArticleentries added to the existing@graph:SKILL.mdandAGENTS.md, each withencodingFormat: "text/markdown",audience.audienceType: "AI agents and LLMs", andisPartOflinking back to veralang.dev.5. CTA button semantic attributes
rel="agent-instructions",type="text/markdown",data-agent-role="skill",data-agent-descriptionadded to the existing "For Agents → SKILL.md" anchor. Symbolic but costs nothing.Validation
python scripts/check_html_examples.py— all 5 Vera code blocks still passpython scripts/check_site_assets.py— site assets up-to-datepython scripts/check_doc_counts.py— counts consistent🤖 Generated with Claude Code