Skip to main content
skill CX Codex

agent-ready-scan-site — Claude Code skill

agent-ready-scan-site scans a website and validates compliance with AI agent standards. Evaluates 23 checks across five categories: discoverability, content accessibility, bot rules, API/auth discovery, and commerce.

Apache-2.0 ★ 141 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-scan-site -a claude-code
Open on GitHub

What agent-ready-scan-site does

The skill sends a request to the scan API and returns readiness from 0 to 5, the status of each check, and fix instructions. It detects robots.txt, sitemap, Link headers, Markdown content negotiation, MCP servers, and agent cards. Output formats: JSON for structured processing or Markdown with actionable steps to reach the next readiness level.

Useful for debugging when an agent cannot access a site—the skill identifies which standard is missing and how to add it.

What it helps with

  • validate whether an agent can read site content
  • identify missing MCP, robots.txt, or OAuth implementations
  • get instructions to enable agent access
  • compare readiness levels across multiple sites
  • debug missing API or contact metadata

Example prompts for the agent

  • Check if my site works with agents
  • Scan example.com for agent readiness and show me how to improve it
  • Compare readiness scores for three services and highlight which needs MCP support

How to install agent-ready-scan-site

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-scan-site -a claude-code

2Manually: put the files in place

~/.claude/skills/scan-site/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/scan-site/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-ready-scan-site

How do I install agent-ready-scan-site in Claude Code?

Run npx skills add fabricioctelles/skills --skill scan-site -a claude-code, then open ~/.claude/skills/scan-site/SKILL.md.

What does this skill do?

It checks whether a site supports AI agents by analyzing robots.txt, sitemap, Link headers, Markdown negotiation, MCP servers, and other standards. Returns a readiness level (0–5) with recommendations.

What are the readiness levels?

Level 0 is Not Ready; level 3 means agents can read content; level 4 includes integrations like MCP or Agent Cards; level 5 adds full auth support and all standards.

Source text

SKILL.md · Apache-2.0
---
name: agent-ready-scan-site
description: >
  Sub-skill: Scan any URL for agent readiness. Checks 23 standards across 5 categories,
  returns readiness level (0-5), status of all checks, and fix instructions.
---
# Skill: Scan Site for Agent Readiness

## What This Skill Does

Scans any website URL and checks whether it implements the standards and protocols that make it accessible to AI agents. Checks 23 standards across 5 categories: discoverability, content accessibility, bot access control, API/auth/MCP discovery, and commerce. Returns a readiness level (0-5), the status of all 23 checks, and fix instructions for any failing checks.

## When to Use It

- Checking whether a site supports agent protocols (MCP, robots.txt, Link headers, etc.)
- Debugging why a site is missing specific agent-readiness checks
- Getting actionable fix instructions to improve a site's agent readiness
- Comparing agent readiness across multiple sites

## How to Call It

Send a POST request to the scan API:

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://example.com", "format": "agent"}
```

### Parameters

- `url` (required): The URL to scan. Must be a valid HTTP or HTTPS URL.
- `format` (optional): Set to `"agent"` for a markdown response with fix instructions, or `"json"` (default) for structured data.

### Using the MCP Server

Alternatively, connect to the MCP server at:

```
https://isitagentready.com/mcp
```

Call the `scan_site` tool with a `url` parameter.

## How to Interpret Results

### JSON Format

The response includes:

- `level`: Integer 0-5 indicating overall readiness
- `levelName`: Human-readable level name (e.g., "Agent-Readable")
- `checks`: Object with 5 categories, each containing individual check results
- `nextLevel`: What's needed to reach the next level
- Each check has `status` ("pass", "fail", or "unableToCheck") and a `message`

### Agent Format

Returns a markdown document listing:
- The site's current score (e.g., "3/5 Agent-Readable")
- All failing checks with descriptions and fix instructions
- If all checks pass, a confirmation message

### Level Scale

| Level | Name | Key Requirements |
|-------|------|-----------------|
| 0 | Not Ready | Fewer than 2 of: robots.txt, sitemap, Link headers |
| 1 | Basic Web Presence | 2 of 3: robots.txt, sitemap, Link headers |
| 2 | Bot-Aware | Level 1 + both: AI bot rules in robots.txt, Content Signals |
| 3 | Agent-Readable | Level 2 + markdown content negotiation |
| 4 | Agent-Integrated | Level 3 + 1 of 4: MCP Server Card, A2A Agent Card, agent skills, API catalog |
| 5 | Agent-Native | Level 4 + 2 of 3: Web Bot Auth, all integrations, auth metadata (OAuth or Auth.md) |

Personal Agent Protocol (Poppy) draft discovery is included in all/API scans as
`personalAgentProtocol`. It validates public metadata and issuer binding, and is
informational: it does not affect readiness levels or percentage scores.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →
site-structure-optimizer aaron-he-zhu site-structure-optimizer — a skill that plans site structure and untangles internal linking: page hierarchy, URLs, hub clusters, orphan pages. It returns a structure score out of 100. CX Codex +1 1,500installs site-crawlability kostja94 site-crawlability — a technical SEO skill that walks through redirect chains, broken links, orphan pages and what AI crawlers can actually read. CX Codex +1 1,200installs SEO Web Analysis MCP — Site Audit & Tech Stack nexgendata-apify SEO Web Analysis MCP — Site Audit & Tech Stack is an MCP server for Claude Code that reveals a site's tech stack, DNS records, SSL status, and WHOIS data. It supports competitive research and security audits. CX Codex +1 9,357installs site-architecture coreyhaines31 site-architecture — a skill for planning page hierarchy, URL structure, navigation, and internal linking when building or restructuring a website. Works on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 135,700installs multipliers.ai Site Auditor multipliers The multipliers.ai Site Auditor MCP server connects to Claude Code and checks whether a website is ready to be cited by LLM-powered search engines, returning a score and findings in about 20 seconds. CX Codex +1 109installs site-launch-checklist samber site-launch-checklist runs an interactive pre-release audit for websites and web apps, covering DNS, security headers, GDPR rules, SEO, and analytics before production deployment. CX Codex +1 5,500installs

From the same set46

The whole set →
agent-ready-dns-aid The agent-ready-dns-aid skill guides DNS-AID records that let agents locate endpoints through DNS. Use it when publishing SVCB or HTTPS records under _agents. CX Codex +1 ★ 141repo stars agent-ready-personal-agent-protocol agent-ready-personal-agent-protocol publishes Personal Agent Protocol (Poppy) draft 0.1 discovery metadata at /.well-known/poppy.json and validates OAuth issuer binding. CX Codex +1 ★ 141repo stars agent-ready-auth-md agent-ready-auth-md publishes an auth.md file and OAuth metadata so agents can discover how to register with a service. Kicks in when a scanner flags the authMd check as failing. CX Codex +1 ★ 141repo stars agent-ready-ard The agent-ready-ard skill guides you through publishing /.well-known/ai-catalog.json so agents can discover MCP servers, A2A agents, skills, and API tools. Use it to add resource discovery to a project. CX Codex +1 ★ 141repo stars ultimate-design-system-master ultimate-design-system-master guides users through an 18-step briefing questionnaire to produce design systems, brand assets, and UI code across 10 specialized generators. CX Codex +1 ★ 141repo stars substack-expert substack-expert — a skill for shaping Substack newsletters, from post structure and SEO fields to reader engagement and free-to-paid conversion. CX Codex +1 ★ 141repo stars pier-cloud A skill for calling the Pier Cloud (Lighthouse) API: JWT auth, contexts, workspaces and FinOps view data through ready-made Python scripts. CX Codex +1 ★ 141repo stars geo-optimization geo-optimization optimizes site content for LLM citations and answer engines like ChatGPT, Perplexity, Claude, and Google AI Overview. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open