What do I need to use Agent Readiness Audit?

The product; What agents will be asked to do; What exists already; Any observed agent failures.

Is Agent Readiness Audit free to use?

Yes — run it free in the browser playground (no API key needed for the sponsored trial, or bring any provider key), or install it into Claude Code, Cursor, ChatGPT and more via npx pm-claude-skills. MIT-licensed and open source.

Agent Readiness Audit

Q: How do I know the Agent Readiness Audit output is good?

The skill verifies itself against its own quality checks: Every score below 3 cites the actual failing artifact (URL, error string, form field), not a vibe; Fixes are specific changes, not "improve the docs"; The audit distinguishes *unwritten* facts (agent can't know) from *buried* facts (agent might find); The fix list is ranked by agent-traffic impact, and states assumptions where traffic is unmeasured.

🔵 Stable🕐 updated 2026-07-02 🔷 SkillSpec L3 pm-agentnative

Audit whether AI agents can actually use your product — docs, APIs, onboarding, errors, and discoverability, evaluated from a non-human user's perspective. Use when asked if a product is agent-ready, to audit a site or API for AI usability, to prepare for agentic traffic, or when agents keep failing against your product. Produces a scored readiness report with per-surface findings and a prioritised fix list. For optimising a single article for AI citation use aeo-optimizer; for designing the MCP server itself use mcp-server-spec.

▶ Run it free — no key needed 📝 Grade your existing draft View SKILL.md ↗

What to give it

▸The product — and its public surfaces (site, docs URL, API reference, status page)

▸What agents will be asked to do — with it — research/compare? sign up? operate it daily?

▸What exists already — llms.txt? MCP server? OpenAPI spec? If unknown, the audit checks

▸Any observed agent failures — the best audit seed there is

✅ The bar it holds itself to

Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.

✓Every score below 3 cites the actual failing artifact (URL, error string, form field), not a vibe

✓Fixes are specific changes, not "improve the docs"

✓The audit distinguishes *unwritten* facts (agent can't know) from *buried* facts (agent might find)

✓The fix list is ranked by agent-traffic impact, and states assumptions where traffic is unmeasured

✓The re-test protocol exists — readiness is a pass rate, not an opinion

⚠️ What it refuses to do

Do not audit from memory of the product — fetch the actual surfaces; they've changed

Do not treat "we have great docs" as evidence — great-for-humans routinely scores 1/4 for agents

Do not recommend blocking agents as a fix unless the business genuinely wants that — then say it in terms *and* technically, consistently

Do not conflate this with SEO/AEO — being quotable is surface 1; being *usable* is the other five

Do not skip the guardrails surface — unmeasured agent traffic is how products discover this problem in an outage

Install

npx pm-claude-skills add --agent claude   # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp

Related skills

🔌 Embed this skill

Drop this on your blog, docs, or site — it renders a "Run this skill" card:

<div data-pm-skill="agent-readiness-audit"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>

💬 Discussion

Agent Readiness Audit is one of 599 open-source professional AI agent skills — all SkillSpec L3. Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog