CtrlK
BlogDocsLog inGet started
Tessl Logo

mlava/agent-ready-api

Use the Agent Ready (agent-ready.dev) REST API to scan any public URL for AI agent-readability against the Vercel Agent Readability Spec, the llmstxt.org standard, and agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). Activates for "scan this site for AI agent-readability", "run an Agent Ready scan on {URL}", "check the Agent Ready score for {URL}", "what's the agent-readability rating for {URL}", or any time the user wants a programmatic readability scan via HTTP. Picks this skill when the user does NOT have the Agent Ready MCP server installed — for MCP, use the `agent-ready-mcp` skill instead.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, highly actionable API skill body with a well-sequenced workflow, validation checkpoints, and strong error-recovery guidance. The main weakness is progressive disclosure: the body points to EXAMPLES.md and REFERENCE.md, but neither file exists in the bundle, leaving those references broken.

Suggestions

Ship the referenced EXAMPLES.md and REFERENCE.md files in the skill bundle (e.g., under references/) so the in-body links resolve, or inline the small amount of content they would hold and drop the links.

Trim the 'When to use' section, which re-lists trigger phrases already present in the frontmatter description.

If EXAMPLES.md only contains Node/Python start-and-poll snippets, consider inlining the Python one (the most common case) and linking only for the rest.

DimensionReasoningScore

Conciseness

Mostly lean with executable curl blocks, a field table, and an error table that earn their tokens; the 'When to use' section partially re-states trigger phrases already in the description and could be trimmed slightly.

4 / 5

Actionability

Copy-paste-ready curl commands for start/poll/ask, a complete runnable polling loop, and a specific summarise-the-findings recipe naming exact response fields and the share URL pattern.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit validation checkpoints ('Do not try to read a score from this response', 'a failed scan carries no usable score'), a poll-until-terminal feedback loop, and a full error-recovery table with 429 Retry-After handling.

5 / 5

Progressive Disclosure

Structure is well-signaled and one level deep (defers language examples to EXAMPLES.md and endpoint/OpenAPI detail to REFERENCE.md), but those referenced files are not present in the bundle, so the navigation promise is unfulfilled — a gap beyond the 'minor organization' anchor.

3 / 5

Total

17

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that clearly states what the skill does and when to use it, with comprehensive natural trigger phrases and explicit disambiguation from the related MCP skill. The only minor gap is that it describes a single scan action rather than a suite of distinct operations.

DimensionReasoningScore

Specificity

Names the domain and a concrete action ('scan any public URL for AI agent-readability') and comprehensively enumerates the specs/standards scanned against, but the skill is essentially a single scan action rather than multiple distinct operations.

4 / 5

Completeness

Explicitly answers both what ('Use the Agent Ready REST API to scan any public URL...') and when ('Activates for ... or any time the user wants a programmatic readability scan via HTTP') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Provides multiple natural trigger phrasings users would actually say ('scan this site for AI agent-readability', 'run an Agent Ready scan on {URL}', 'check the Agent Ready score', 'agent-readability rating') with synonyms.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Agent Ready REST API scan) with distinct triggers and explicit disambiguation from the sibling MCP skill ('for MCP, use the agent-ready-mcp skill instead'), minimizing conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents