Agent Skills index exists

agent_protocol_agent_skills

Checks if an Agent Skills discovery index is published.

What does this rule check?

An Agent Skills index at /.well-known/agent-skills/index.json lists the skills (capabilities, tools, actions) your site makes available to AI agents. Each skill entry includes name, type, description, URL, and integrity hash.

Why is this important?

Without a skills index, AI agents cannot discover what actions they can perform on your site. This is essential for agentic workflows where agents need to find and compose capabilities across services.

How to fix

Publish /.well-known/agent-skills/index.json per the Agent Skills Discovery RFC v0.2.0 with a skills array listing each capability.

Examples

GET /.well-known/agent-skills/index.json

HTTP/1.1 404 Not Found

GET /.well-known/agent-skills/index.json

HTTP/1.1 200 OK
Content-Type: application/json

{"$schema": "...", "skills": [{"name": "search", "type": "tool", "description": "Search products", "url": "/skills/search.json"}]}

Agent fix snippet

Copy this snippet and paste it into your AI coding agent to fix this issue automatically.

Publish /.well-known/agent-skills/index.json:

{
  "$schema": "https://agentskills.io/schema/v0.2.0",
  "skills": [
    {
      "name": "search",
      "type": "tool",
      "description": "Search our catalog",
      "url": "/skills/search.json",
      "sha256": "abc123..."
    }
  ]
}