Skip to content

Document agent readiness checks for mint score #5346

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 4 commits into from
Apr 14, 2026
Merged

Document agent readiness checks for mint score #5346

Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
99b5fc0
Document agent readiness checks including new structured data check
mintlify[bot] Apr 14, 2026
6523327
Apply suggestion from @ethanpalm
ethanpalm Apr 14, 2026
1b055a0
Apply suggestion from @ethanpalm
ethanpalm Apr 14, 2026
920cac8
Apply suggestion from @ethanpalm
ethanpalm Apr 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions cli/commands.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Commands"
description: "Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint analytics, and more."

Check warning on line 3 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L3 

Use 'Dev' instead of 'dev'.
keywords: ["CLI", "mint", "commands", "flags", "reference"]
---

Expand Down Expand Up @@ -141,7 +141,7 @@
| --- | --- |
| `--page` | Filter conversations that reference a specific page in sources. |

#### `mint analytics conversation view <conversation-id>`

Check warning on line 144 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L144 

'````' should use sentence-style capitalization.

View a single conversation by ID. Use `mint analytics conversation list` to get IDs.

Expand All @@ -157,7 +157,7 @@
mint analytics conversation buckets list
```

#### `mint analytics conversation buckets view <bucket-id>`

Check warning on line 160 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L160 

'````' should use sentence-style capitalization.

View conversations in a category bucket. Use `mint analytics conversation buckets list` to get IDs.

Expand All @@ -175,7 +175,7 @@
mint config <subcommand> <key> [value]
```

| Subcommand | Description |

Check warning on line 178 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L178 

Use 'subcommands?' instead of 'Subcommand'.
| --- | --- |
| `set <key> <value>` | Set a configuration value. |
| `get <key>` | Display a configuration value. |
Expand Down Expand Up @@ -241,7 +241,7 @@
| `--local-schema` | Allow validation of locally hosted OpenAPI files served over HTTP. Only supports HTTPS in production. |

<Note>
The standalone `mint openapi-check` command is deprecated. Use `mint validate` instead.

Check warning on line 244 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L244 

In general, use active voice instead of passive voice ('is deprecated').
</Note>

---
Expand Down Expand Up @@ -286,10 +286,38 @@

| Flag | Description |
| --- | --- |
| `--format` | Output format: `table` (default, colored), `plain` (pipeable TSV), or `json`. |

Check warning on line 289 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L289 

Spell out 'TSV', if it's unfamiliar to the audience.

The command displays an overall readiness score and a breakdown of individual checks with pass/fail indicators.

### Checks

The score evaluates the following areas:

| Check | What it verifies |
| --- | --- |
| `llmsTxtExists` | Agents can reach an [llms.txt](/ai/llmstxt) file at the site root. |
| `llmsTxtValid` | The `llms.txt` file follows the expected format with headings, blockquote summary, and Markdown links. |
| `llmsTxtSize` | The llms.txt file stays within the size threshold so models can consume it without truncation. |

Check warning on line 301 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L301 

Use 'LLMs?' instead of 'llms'.
| `llmsTxtLinksResolve` | Links inside llms.txt resolve to live pages. |

Check warning on line 302 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L302 

Use 'LLMs?' instead of 'llms'.
| `llmsTxtLinksMarkdown` | Links inside llms.txt use markdown syntax. |

Check warning on line 303 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L303 

Use 'LLMs?' instead of 'llms'.

Check warning on line 303 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L303 

Use 'Markdown' instead of 'markdown'.
| `llmsTxtDirective` | The llms.txt file contains usage directives. |

Check warning on line 304 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L304 

Use 'LLMs?' instead of 'llms'.
| `llmsTxtFullExists` | An llms-full.txt file is available for models that need the complete content. |

Check warning on line 305 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L305 

Use 'LLMs?' instead of 'llms'.
| `llmsTxtFullSize` | The llms-full.txt file is within a reasonable size range. |

Check warning on line 306 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L306 

Use 'LLMs?' instead of 'llms'.
| `llmsTxtFullValid` | The llms-full.txt file contains valid content with headings. |

Check warning on line 307 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L307 

Use 'LLMs?' instead of 'llms'.
| `llmsTxtFullLinksResolve` | Links inside llms-full.txt resolve to live pages. |

Check warning on line 308 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L308 

Use 'LLMs?' instead of 'llms'.
| `skillMd` | A [skill.md](/ai-native#skill-md) file is discoverable for agent tool use. |
| `contentNegotiationMarkdown` | The site returns markdown when requested through content negotiation. |

Check warning on line 310 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L310 

Use 'Markdown' instead of 'markdown'.
| `contentNegotiationPlaintext` | The site returns plain text when requested through content negotiation. |
| `mcpServerDiscoverable` | An [MCP server](/ai/model-context-protocol) is discoverable for tool-based agents. |
| `mcpToolCount` | The MCP server exposes at least one tool. |
| `openApiSpec` | An OpenAPI or Swagger specification is available at a standard path. |
| `robotsTxtAllowsAI` | The robots.txt file does not block AI crawlers. |
| `sitemapExists` | A sitemap is available for page discovery. |
| `structuredData` | The homepage contains [JSON-LD](https://json-ld.org/) structured data (`<script type="application/ld+json">`). Reports the number of JSON-LD blocks and the schema types found. |
Comment thread
ethanpalm marked this conversation as resolved.
Outdated

Child checks only run when their parent check passes. For example, `llmsTxtValid` only runs if `llmsTxtExists` passes first.

---

## `mint new`
Expand Down Expand Up @@ -344,7 +372,7 @@

## Telemetry

The CLI collects anonymous usage telemetry to help improve Mintlify. Telemetry data includes the command name, CLI version, operating system, and architecture. Mintlify does **not** collect personally identifiable information, project content, or file paths.

Check warning on line 375 in cli/commands.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

cli/commands.mdx#L375 

Did you really mean 'informat'?

By default, the CLI collects telemetry data. You can opt out at any time using the `--telemetry` flag:

Expand Down
Loading