agenticweb.wiki

developer.gemini.com agentic web readiness

B Manifest validity: 33% (1/3 valid, 10 errors, 7 warnings) · Surface score 41 (coverage 30 + breadth 6 + conformance 5). 4 standards observed across 3 of 9 steps; 3 manifests present (+ robots.txt), 10 errors, 7 warnings. Checked 2026-10-25 23:39:35 UTC. This grades the agent-facing files published at developer.gemini.com, not the organisation's products.

Badge for a README: ![agentic web grade](https://agenticweb.wiki/badge/developer.gemini.com.svg) · JSON · Markdown · Re-check now

Coverage by step

01 Discovernothing observed02 Identifynothing observed03 Permitnothing observed04 Readllms.txt, Markdown for Agents05 ActAgent Skills06 CoordinateA2A07 Paynothing observed08 Presentnothing observed

Manifests

ManifestResultFindings
Agentic Resource Discovery
/.well-known/ard.json
absent HTTP 404
AI Catalog well-known file
/.well-known/ai-catalog.json
absent HTTP 404
MCP Server Cards (SEP-2127)
/mcp/server-card
absent HTTP 404
Agent2Agent Protocol
/.well-known/agent-card.json
errors
  • skills[0].tags missing (required)
  • skills[1].tags missing (required)
  • skills[2].tags missing (required)
  • supportedInterfaces[0].protocolBinding missing
  • supportedInterfaces[0].protocolVersion missing
  • supportedInterfaces[1].protocolBinding missing
  • supportedInterfaces[1].protocolVersion missing
  • protocolVersion missing; clients cannot tell which A2A revision the card follows
View valid /.well-known/agent-card.json template for developer.gemini.com
{
  "name": "Developer",
  "description": "Developer and what it offers to agents",
  "version": "1.0.0",
  "provider": {
    "organization": "Developer",
    "url": "https://developer.gemini.com/"
  },
  "documentationUrl": "https://developer.gemini.com/AGENTS.md",
  "supportedInterfaces": [
    {
      "url": "https://developer.gemini.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "url": "https://developer.gemini.com/a2a",
  "protocolVersion": "1.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "answer",
      "name": "Answer questions",
      "description": "Answer questions about Developer.",
      "tags": [
        "qa"
      ],
      "examples": [
        "What does Developer do?"
      ]
    }
  ],
  "securitySchemes": {},
  "securityRequirements": []
}
llms.txt
/llms.txt
valid
AGENTS.md
/AGENTS.md
absent HTTP 404
Agent Skills
/.well-known/agent-skills/index.json
errors
  • skills[0].url missing
  • skills[1].url missing
  • skills[2].url missing
  • skills[0].digest missing
  • skills[1].digest missing
  • skills[2].digest missing
View valid /.well-known/agent-skills/index.json template for developer.gemini.com
{
  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
  "skills": [
    {
      "name": "developer",
      "type": "skill-md",
      "description": "Developer and what it offers to agents",
      "url": "https://developer.gemini.com/.well-known/agent-skills/developer/SKILL.md",
      "digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
    }
  ]
}
api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs
/.well-known/api-catalog
absent HTTP 404
AI Crawler User-Agent Tokens in robots.txt
/robots.txt
no AI tokens
  • no AI crawler token named (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, ...); the policy for them is whatever User-agent: * says (allowed)
  • no Agentmap: line (optional convention pointing agents at /.well-known/ard.json)
  • no Content-Signal: line (optional; states ai-train / search / ai-input preferences)
security.txt (RFC 9116)
/.well-known/security.txt
absent HTTP 404
auth.md
/auth.md
absent HTTP 404
Open Knowledge Format
/okf/index.md
absent HTTP 404

What an agent can call

Standards observed

Cheapest next steps

  1. Agentic Resource Discovery: a catalog at /.well-known/ard.json lets agents discover your APIs, MCP servers and data in one fetch (emerging spec — publish only if you run the underlying endpoints; generate via MCP template({"id": "ard", "domain": "developer.gemini.com"}))
  2. AGENTS.md: instructions for coding agents working on or with the site
    Generate starter /AGENTS.md for developer.gemini.com
    # Developer for agents
    
    Developer and what it offers to agents
    
    ## Read the data, not the HTML
    - Index: https://developer.gemini.com/llms.txt
    - API description: https://developer.gemini.com/openapi.json
    - Discovery catalog: https://developer.gemini.com/.well-known/ard.json
    
    ## Calling
    - MCP server (Streamable HTTP): https://developer.gemini.com/mcp
    - Rate limits and authentication: describe them here
    
    ## Conventions
    - How to cite or attribute content
    - What not to do (no scraping of /account/, no automated sign-ups, etc.)
    
    Contact: security@developer.gemini.com
    
  3. api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs: an RFC 9727 linkset pointing at your OpenAPI description (conditional spec — publish only if you run the underlying endpoints; generate via MCP template({"id": "api-catalog-rfc9727", "domain": "developer.gemini.com"}))

Agent pre-flight & practical readiness

Preferred mode: a2a (fallback llms_txt). Send the task to the A2A agent endpoint named in the card. Use the card's skills instead of crawling pages.

Fetch: POST https://developer.gemini.com/rest-api/rest-api Send an A2A message to this agent endpoint. The card lists the skills.

Practical readability: exa_parsable yes, markdown negotiation yes, render markdown_native, HTML quality high, first content at byte 0.

AI crawler posture: open_to_all · Assistant access: OpenAI allowed, Anthropic allowed, Google allowed, Perplexity allowed, Exa allowed.

Readiness subscores: reach 20/20, readability 30/30, capabilities 12/35, conformance 5/15, total 67/100, grade A.

How the grade is made

+10 per lifecycle step with a standard observed, counting manifests that validate or that the probe rule for the standard recognises (a valid MCP server card counts for MCP; max 90); +3 per observed standard beyond the first two (max 15); conformance +15 (+10 with one manifest) minus 5 per agent-facing manifest with errors, never below 0 (security.txt is reported, not scored). Lifecycle grade: A+ >= 60, A >= 45, B >= 30, C >= 20, D >= 10. Strict 100-point composite (subscores.total_100 / subscores.grade_100): reach_and_policy (20) + readability (30) + capabilities (35) + conformance (15), where A+ >= 80, A >= 65, B >= 45, C >= 28, D >= 15. Errors are specification violations; warnings are best-practice gaps. Only public paths are fetched, without credentials, so standards that need a login (skipped in the probe) are not counted either way. The same report is the validate_manifest tool on the MCP server.

JSON · Markdown · probe rules