---
title: "Stoplight: agent readability profile: Agent Ready HTML"
description: "Stoplight scores 6 of 16 on the read-layer rubric: initial HTML, status codes, llms.txt, markdown, JSON-LD, OpenAPI and code. Read 2026-11-04."
canonical: https://agentreadyhtml.com/platforms/stoplight/
site: "Agent Ready HTML"
last_updated: 2026-11-04
section: "Platforms"
---

# Stoplight: agent readability profile: Agent Ready HTML

> Stoplight scores 6 of 16 on the read-layer rubric: initial HTML, status codes, llms.txt, markdown, JSON-LD, OpenAPI and code. Read 2026-11-04.

Source: https://agentreadyhtml.com/platforms/stoplight/
Site: Agent Ready HTML
Last reviewed: 2026-11-04

# 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

```text
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

| Key | Score | Evidence | Source |
| --- | --- | --- | --- |
| Content in the initial HTML | 1, with setup | Hosted 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 codes | 2, on by default | A 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 generation | 0, not offered | No 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 linking | 0, not offered | No 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 request | 0, not offered | Not 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 output | 0, not offered | Not 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 exposure | 2, on by default | OpenAPI 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 code | 1, with setup | Code 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 developer |  | High: 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](https://blog.stoplight.io/smartbear-to-acquire-stoplight-to-deliver-industrys-broadest-portfolio-of-api-development-capabilities), 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](https://github.com/stoplightio/elements), 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](https://stoplight.io/), 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

-   [Stoplight against Redocly](https://agentreadyhtml.com/compare/redocly-vs-stoplight/)
-   [Alternatives to Stoplight](https://agentreadyhtml.com/platforms/stoplight/alternatives/)
-   [Stoplight: vendor profile](https://agentreadyhtml.com/vendors/stoplight/)
-   [Stoplight home page](https://stoplight.io/)

## Sources

1.  [SmartBear to acquire Stoplight](https://blog.stoplight.io/smartbear-to-acquire-stoplight-to-deliver-industrys-broadest-portfolio-of-api-development-capabilities) 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) https://github.com/stoplightio/elements, read 4 November 2026
4.  [stoplight.io](https://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

Edition

Crawl

2026-11-04

Page updated

2026-11-04

Method

How the viewer reads a page, how a file is graded and how a platform is scored: [the method page](https://agentreadyhtml.com/method/).