agent-ready-ard — скилл для Claude Code: каталог ИИ-агентов
Скилл agent-ready-ard для Claude Code помогает опубликовать /.well-known/ai-catalog.json, чтобы агенты находили MCP-серверы, A2A-агентов, скиллы и API-инструменты. Задача — настроить обнаружение ресурсов проекта.
Apache-2.0 ★ 141 обновлён 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-ard -a claude-codeЧто делает agent-ready-ard
Скилл описывает требования к манифесту ARD: корневой путь /.well-known/ai-catalog.json, JSON-тип содержимого, HTTP 200 и открытый CORS. В каталоге нужны сведения о хосте и записи ресурсов; у каждой записи должно быть ровно одно из полей url или data. Идентификаторам записей задают формат urn:air:<your-fqdn>:<namespace>:<name>, а для каждой добавляют 2–5 representativeQueries.
Помимо well-known-пути, скилл перечисляет ссылки на манифест через robots.txt, HTML и DNS. Проверку можно запустить запросом к https://isitagentready.com/api/scan; сканер проверяет структуру и сообщает о проблемных идентификаторах и MIME-типах, но не останавливает проверку из-за них. ARD — черновая спецификация версии 0.9, поэтому результат сканирования не подтверждает полное соответствие стандарту.
Какие задачи решает
- опубликовать каталог MCP-серверов и API-инструментов
- добавить сведения об A2A-агентах в манифест
- проверить структуру ARD-каталога
- объявить адрес каталога через DNS или HTML
Примеры запросов агенту
- Подготовь для проекта манифест ARD в
/.well-known/ai-catalog.jsonдля наших MCP-серверов и API-инструментов. - Проверь, какие поля нужны записям каталога ARD, и предложи структуру для наших A2A-агентов.
- Подскажи, как объявить наш манифест ARD через
robots.txtи проверить его сканером.
Как установить agent-ready-ard
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-ard -a claude-code2Вручную: положить файлы
~/.claude/skills/ard/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ard/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-ard -a codex2Вручную: положить файлы
.agents/skills/ard/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-ard -a cursor2Вручную: положить файлы
.cursor/skills/ard/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/ard2Вручную: положить файлы
.github/skills/ard/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-ard -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/ardВручную: положить файлы
.devin/skills/ard/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об agent-ready-ard
Как установить agent-ready-ard в Claude Code?
Выполните npx skills add fabricioctelles/skills --skill ard -a claude-code. Файл скилла находится в ~/.claude/skills/ard/SKILL.md.
Что делает agent-ready-ard?
Он помогает создать каталог ARD по пути /.well-known/ai-catalog.json и описывает, как агенты находят через него MCP-серверы, A2A-агентов, скиллы и API-инструменты.
Что проверяет сканер ARD?
Он проверяет структуру манифеста и сообщает о некорректных идентификаторах и MIME-типах, но такие замечания не прерывают проверку. Спецификация ARD версии 0.9 — черновик.
Исходный текст
SKILL.md · Apache-2.0
---
name: agent-ready-ard
description: >
Sub-skill: Implement ARD (Agentic Resource Discovery). Publish
/.well-known/ai-catalog.json so agents can discover MCP servers, A2A agents,
skills and API tools (agenticresourcediscovery.org / ai-catalog).
---
# Implement ARD (Agentic Resource Discovery)
Publish a capability manifest so agents can discover your MCP servers, A2A
agents, skills and API tools, per the
[ARD spec](https://agenticresourcediscovery.org/) and the
[ai-catalog](https://github.com/Agent-Card/ai-catalog) data model.
The ARD spec is a v0.9 draft, so the scanner validates structure only and
reports non-conformant identifiers and media types without failing the check.
Note that `specVersion` refers to the ai-catalog data model, not the ARD spec
version, which is why the example below reads `1.0`. The scanner only requires
it to be a non-empty string.
## Requirements
- Serve `/.well-known/ai-catalog.json` from the origin root with
`Content-Type: application/json`, HTTP 200, and `Access-Control-Allow-Origin: *`
- Include a `specVersion` string and a non-empty `entries` array
- Add a `host` object with `displayName` and a stable `identifier`
- Each entry needs an `identifier`, a `displayName`, and a `type` media type
- Each entry needs **exactly one** of `url` or `data` — never both, never neither
(spec §3.4)
- Use `urn:air:<your-fqdn>:<namespace>:<name>` for entry identifiers
- Add 2-5 `representativeQueries` per entry so registries can build semantic
embeddings
## Example
```json
{
"specVersion": "1.0",
"host": {
"displayName": "Example Systems",
"identifier": "did:web:example.com"
},
"entries": [
{
"identifier": "urn:air:example.com:server:weather",
"displayName": "Weather Telemetry Server",
"type": "application/mcp-server-card+json",
"url": "https://example.com/mcp/weather.json",
"representativeQueries": [
"what is the wind speed in Chicago",
"get the 5-day forecast for Seattle"
]
}
]
}
```
## Additional discovery mechanisms
The well-known path is the primary mechanism. Any of the following can point
agents at a manifest hosted elsewhere (spec §6.1), and the scanner reports which
ones you publish:
- **robots.txt**: add an `Agentmap: https://example.com/ai-catalog.json` directive
- **HTML**: add `<link rel="ai-catalog" href="/.well-known/ai-catalog.json">` to
`<head>`
- **DNS**: publish a `_catalog._agents.example.com` TXT record containing
`url=https://example.com/.well-known/ai-catalog.json`
- **DNS**: publish a `_search._agents.example.com` SRV record to advertise a
semantic search endpoint (reported only; the scanner never queries it)
## Validate
```
POST https://isitagentready.com/api/scan
Content-Type: application/json
{"url": "https://YOUR-SITE.com"}
```
Check that `checks.discovery.ard.status` is `"pass"`.
© fabricioctelles · Apache-2.0 · fabricioctelles/skills