Agent Ready HTML

Stoplight: what an agent reads

In short

Stoplight does not publish an llms.txt on its own docs host as of 2026-11-04. Stoplight totals 6 of 16 on the eight numeric keys, from cited documentation read 4 November 2026. It also does not document markdown output for agents.

rubric.txt stoplight

initial_html_by_default  = 1
real_status_codes        = 2
llms_txt_generation      = 0
llms_txt_linking         = 0
markdown_negotiation     = 0
jsonld_output            = 0
openapi_exposure         = 2
fenced_code              = 1
total                    = 6 of 16

Read 2026-11-04. Documentation, not a test build.

Stoplight Docs platform, SmartBear

API design and docs platform owned by SmartBear; no llms.txt was found on its docs host, and its Elements reference is a React component.

Work left to the developer: High: write llms.txt by hand, host it yourself, and prerender any embedded Elements reference.

The nine scores

KeyScoreEvidenceSource
Content in the initial HTML1, with setupHosted docs depend on configuration; Elements embeds render in the browser. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.github.com/stoplightio/elements, 2026-11-04
Real status codes2, on by defaultA made-up path on stoplight.io returned 404. Observed on the vendor's own site with a plain fetch on 2026-11-04; the vendor's own site may not use default settings.GET stoplight.io/agent-ready-html-missing-path-check: 404 as observed, 2026-11-04
llms.txt generation0, not offeredNo documented generator; none found on docs.stoplight.io. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.https://docs.stoplight.io/llms.txt (404 on the read date), 2026-11-04
llms.txt linking0, not offeredNo file to link. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.https://docs.stoplight.io/llms.txt (404 on the read date), 2026-11-04
Markdown on request0, not offeredNot observed and not documented. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.blog.stoplight.io/smartbear-to-acquire-stoplight-to-del…, 2026-11-04
JSON-LD output0, not offeredNot documented. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.github.com/stoplightio/elements, 2026-11-04
OpenAPI exposure2, on by defaultOpenAPI is the source format of every Stoplight project. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.github.com/stoplightio/elements, 2026-11-04
Fenced, tagged code1, with setupCode samples are generated in the UI; plain-fetch output not tested. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.github.com/stoplightio/elements, 2026-11-04
Work left to the developerHigh: write llms.txt by hand, host it yourself, and prerender any embedded Elements reference. No native agent files. Not test-built: a Stoplight workspace needs an account. Score from the documentation page cited, read 2026-11-04.https://docs.stoplight.io/llms.txt (404 on the read date), 2026-11-04

Test build

Not test-built: the scores above come from the documentation pages cited in each row, read 4 November 2026, because the platform needs an account or a paid plan. The reason is in each evidence cell.

What the documentation says

Each statement below carries its source and the date read. Statements a vendor makes about itself are labelled as vendor claims.

  • SmartBear announced the acquisition of Stoplight in August 2023. [vendor claim, 2023-08-22] source, read 4 November 2026.
  • docs.stoplight.io returned 404 for /llms.txt on 2026-11-04, and stoplight.io returned 404 for /llms.txt the same day. [primary source] https://docs.stoplight.io/llms.txt (404 on the read date), read 4 November 2026.
  • Stoplight Elements, the embeddable API reference, is distributed as React components and web components. [primary source] source, read 4 November 2026.
  • On 2026-11-04 stoplight.io answered Accept: text/markdown with text/html, so no markdown negotiation was observed. [primary source] source, read 4 November 2026.

What it does not do

  • Does not publish an llms.txt on its own docs host as of 2026-11-04.
  • Does not document markdown output for agents.

Compare and replace

Sources

  1. SmartBear to acquire Stoplight https://blog.stoplight.io/smartbear-to-acquire-stoplight-to-deliver-industrys-broadest-portfolio-of-api-development-capabilities, read 4 November 2026
  2. docs.stoplight.io https://docs.stoplight.io/llms.txt (404 on the read date), read 4 November 2026
  3. Stoplight Elements README https://github.com/stoplightio/elements, read 4 November 2026
  4. stoplight.io https://stoplight.io/, read 4 November 2026
  5. stoplight.io https://stoplight.io/agent-ready-html-missing-path-check (a probe path that answers 404 on purpose), read 4 November 2026

Last reviewed 4 November 2026