--- title: "Waymark report for huggingface.co" canonical: "https://waymark.genedai.me/score/huggingface.co" last-updated: "2026-08-24T02:14:44.263Z" --- # Waymark report for huggingface.co Waymark scored huggingface.co 68.7/100 (C) on 24 Aug 2026. Score: 68.7/100 — Blockers remain Scanned: 2026-08-24T02:14:44.263Z Canonical report: https://waymark.genedai.me/score/huggingface.co ## Layer breakdown - Discovery: 11.1/20 (9 of 18 eligible checks passed) - Access: 22.9/30 (18 of 27 eligible checks passed) - Usability: 27.8/40 (10 of 16 eligible checks passed) - Payments: N/A (excluded from the denominator) ## Findings ### 1. llms.txt - Layer: discovery - Result: failed - Evidence: llms.txt status 404. - Recommended fix: Add /llms.txt describing the site for language models. ### 2. AGENTS.md - Layer: discovery - Result: failed - Evidence: agents.md status 404. - Recommended fix: Publish /agents.md with agent-oriented usage notes. ### 3. JSON-LD structured data - Layer: access - Result: failed - Evidence: No JSON-LD on the homepage. - Recommended fix: Add JSON-LD (Organization, WebSite, or SoftwareApplication). ### 4. OpenAPI / Swagger link - Layer: access - Result: failed - Evidence: No OpenAPI/Swagger link in HTML. - Recommended fix: Link to an OpenAPI or Swagger document from the homepage. ### 5. html lang attribute - Layer: access - Result: failed - Evidence: Missing lang on . - Recommended fix: Set (or the correct language). ### 6. CORS / API hint - Layer: access - Result: partial - Evidence: No CORS header or obvious API path. - Recommended fix: If you expose an API, send Access-Control-Allow-Origin for intended clients. ### 7. MCP well-known card - Layer: usability - Result: failed - Evidence: MCP mentioned without a well-known card. - Recommended fix: Publish /.well-known/mcp.json describing your MCP server. ### 8. Webhook or API docs - Layer: usability - Result: failed - Evidence: No webhook/API docs mention. - Recommended fix: Document webhooks and REST/RPC APIs for agents. ### 9. robots.txt AI policy - Layer: discovery - Result: partial - Evidence: robots.txt present but no named AI crawlers. - Recommended fix: Name GPTBot, ClaudeBot, Google-Extended, PerplexityBot and state allow or deny. ### 10. llms.txt index - Layer: discovery - Result: failed - Evidence: Missing /llms.txt. - Recommended fix: Add a markdown index at /llms.txt. ### 11. llms-full.txt - Layer: discovery - Result: failed - Evidence: llms-full.txt status 404. - Recommended fix: Optionally publish /llms-full.txt for one-shot ingest. ### 12. JSON-LD entities - Layer: access - Result: failed - Evidence: No JSON-LD. - Recommended fix: Embed Organization, Product, Offer, SoftwareApplication, or FAQPage. ### 13. Markdown negotiation - Layer: access - Result: failed - Evidence: Homepage did not negotiate markdown. - Recommended fix: Respond to Accept: text/markdown with a markdown body. ### 14. /index.md fallback - Layer: access - Result: failed - Evidence: index.md status 404. - Recommended fix: Serve a markdown homepage at /index.md. ### 15. MCP server card - Layer: usability - Result: partial - Evidence: MCP mentioned without a card. - Recommended fix: Publish /.well-known/mcp.json or mcp/server-card.json. ### 16. MCP Apps UI hint - Layer: usability - Result: failed - Evidence: No MCP Apps hint (N/A unless you return UI). - Recommended fix: If you return UI, declare io.modelcontextprotocol/ui resources. ### 17. ai-plugin.json - Layer: discovery - Result: failed - Evidence: No /.well-known/ai-plugin.json. - Recommended fix: Optionally publish a plugin-style capability manifest. ### 18. change-password well-known - Layer: access - Result: failed - Evidence: Login surface without /.well-known/change-password. - Recommended fix: If users have passwords, serve /.well-known/change-password. ### 19. llms.txt size and links - Layer: discovery - Result: failed - Evidence: No llms.txt to score. - Recommended fix: Keep /llms.txt over ~200 characters with absolute URLs to docs. ### 20. Idempotency signal - Layer: usability - Result: partial - Evidence: API surface without idempotency notes. - Recommended fix: Document idempotency keys for mutating calls. ### 21. CLI tool - Layer: usability - Result: failed - Evidence: No CLI mention. - Recommended fix: Publish an official CLI. ### 22. RSS or Atom document - Layer: access - Result: partial - Evidence: No /feed or /rss.xml document. - Recommended fix: Publish /rss.xml or /atom.xml. ### 23. Sitemap lastmod - Layer: discovery - Result: failed - Evidence: Sitemap without lastmod. - Recommended fix: Add lastmod dates to sitemap entries. ### 24. Package homepage match - Layer: discovery - Result: failed - Evidence: No npm package homepage matching huggingface.co. - Recommended fix: Publish an official package whose homepage is this domain. ## Interpretation Public technical snapshot; not a guarantee of task completion. Private and authenticated workflows are outside this scan. Cite scanned_at and the canonical report URL; the URL serves the latest completed snapshot and can change after a rescan. The official Waymark score is Discovery 20 / Access 30 / Usability 40 / Payments 10. N/A and scanner-error checks drop out of the denominator; they are not scored as failures. An observed agent journey is supporting evidence and does not change the numeric score.