Skip to content

Agent readiness score#5460

Open
ethanpalm wants to merge 15 commits intomainfrom
agent-readiness-score
Open

Agent readiness score#5460
ethanpalm wants to merge 15 commits intomainfrom
agent-readiness-score

Conversation

@ethanpalm
Copy link
Copy Markdown
Collaborator

@ethanpalm ethanpalm commented Apr 20, 2026

Documentation changes

Adds explanation of each agent rank score and a prompt to improve what it checks for.

Closes https://linear.app/mintlify/issue/DOC-358/add-docs-for-each-agent-rank-check


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Low Risk
Documentation-only change that adds a new AI/agent-readiness page and tweaks navigation ordering; no runtime or security-sensitive code is touched.

Overview
Adds a new ai/agent-readiness-checks.mdx page documenting Agent Rank readiness checks (e.g., llms.txt, llms-full.txt, skill.md, content negotiation, MCP, OpenAPI, robots/sitemap/structured data, and latency) with why it matters, how to improve, and copyable remediation prompts.

Updates docs.json navigation to surface ai/agent-readiness-checks under Optimize, and reorders the Optimize section so optimize/* pages (including pdf-exports) appear as top-level entries rather than being interleaved within the Integrations group.

Reviewed by Cursor Bugbot for commit 59cd45c. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify-development
Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 20, 2026, 11:10 PM

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 20, 2026, 11:12 PM

@mintlify-development
Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 20, 2026, 11:10 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants