simonwillison.net
Technical readiness score
One run shows how an agent performed, but it does not determine the technical score.
Task
18 steps2 reasoning steps6 searches
These checks describe whether an ordinary agent can enter, read, and operate the public site.
Agents can reach the site
Crawler access, bot defenses, and explicit agent policy.
Core content is available
Useful content remains accessible without a fragile browser-only path.
Navigation fails safely
Redirects and missing pages give agents a recoverable path.
Controls are understandable
Forms and interactive controls expose usable names and structure.
Optional surfaces appear only when the scan finds positive evidence that the site offers them.
Needs work
9 of 18 mature checks passed
Blocked
1 of 9 mature checks passed
Critical access gaps come first, followed by gaps in capabilities the site advertises.
Return a real HTTP 404 (or 410) status for nonexistent paths - never a 200 with your app shell, which makes agents believe every path exists. For full credit, give the 404 response a short markdown body pointing agents at your sitemap, llms.txt, or docs index. Verify with `curl -s -o /dev/null -w "%{http_code}" https://yourdomain.com/some-path-that-does-not-exist` - it must print 404.
Publish an OpenAPI (Swagger) specification at /openapi.json or /api/openapi.yaml. This is how agents understand your API surface automatically.
Return structured JSON error responses with error codes, messages, and resolution hints. Agents can't parse HTML error pages.
Expose a public REST or GraphQL API. AI agents need programmatic access - not just a web UI - to integrate with your product.
Create a developer portal at /developers with API keys, documentation, quickstart guides, and a sandbox environment.
Applicable evidence is grouped by how it contributes to this preview model. Bonus checks appear only when they add points.
The complete Ora audit uses evidence from the scan on . After applying changes, run another scan from the homepage to refresh these recommendations.
A weekly report with ranking changes, new agent feedback, and score alerts for simonwillison.net.
Source: Ora API
Snapshot 2026-08-18T17-16-52-092Z