К основному содержанию
скилл CX Codex

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fabricioctelles/skills --skill agent-ready-ard -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/ard/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ard/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
Neuronto ARD Registry: Agentic Resource Discovery (ARD) Index neuronto Neuronto ARD Registry: Agentic Resource Discovery (ARD) Index — MCP-сервер для Claude Code, который ищет ресурсы по публичным ARD-реестрам и показывает схемы MCP-инструментов. CX Codex +1 ★ 58звёзд репо ds-ready aicodeking Скилл ds-ready для Claude Code автоматизирует цикл создания пулл-реквеста, но останавливается перед слиянием. CX Codex +1 534установок ai-ready официальный github Скилл ai-ready анализирует кодовую базу и создаёт AGENTS.md, copilot-instructions.md, воркфлоу CI и шаблоны задач с учётом истории pull request. CX Codex +1 366установок agent-ready mblode Скилл agent-ready для Claude Code и Codex превращает отчёты о готовности сайта для агентов и логи 404 в изменения сайта, тесты и проверку ответов. Выявляет проблемы с обнаружением страниц документации агентами. CX Codex +1 257установок ukg-ready membrane Интеграция с HCM-системой UKG Ready через Membrane CLI. Помогает управлять сотрудниками, табелями, отпусками и отчётами прямо в диалоге с агентом. CX Codex +1 208установок exam-ready официальный github Скилл exam-ready для GitHub Copilot готовит к экзамену по учебным материалам и программе курса. Разбирает темы по конспектам или PDF и составляет вопросы для тренировки. CX Codex +1 187установок

Из того же набора46

Весь набор →
agent-ready-mpp Скилл agent-ready-mpp помогает внедрить Machine Payment Protocol (MPP) в OpenAPI, добавляя разметку x-payment-info для платных эндпоинтов вашего API. CX Codex +1 ★ 141звёзд репо agent-ready-dns-aid Скилл agent-ready-dns-aid для Claude Code публикует DNS-AID-записи, чтобы агенты находили endpoint через DNS. Настраивает SVCB или HTTPS-записи в пространстве _agents. CX Codex +1 ★ 141звёзд репо agent-ready-personal-agent-protocol Скилл agent-ready-personal-agent-protocol публикует метаданные Personal Agent Protocol (Poppy) черновика 0.1 по адресу /.well-known/poppy.json и проверяет привязку OAuth issuer. CX Codex +1 ★ 141звёзд репо agent-ready-auth-md Скилл agent-ready-auth-md публикует для сервиса документ auth.md и метаданные OAuth, чтобы агенты находили способ регистрации. Включается, когда сканер отмечает проверку authMd как неуспешную. CX Codex +1 ★ 141звёзд репо agent-ready-scan-site Скилл agent-ready-scan-site сканирует сайт и проверяет, готов ли он для работы с AI-агентами. Анализирует 23 стандарта по пяти категориям: видимость, доступность контента, управление ботами, API и коммерция. CX Codex +1 ★ 141звёзд репо ultimate-design-system-master Скилл ultimate-design-system-master для Claude Code пошагово создаёт дизайн-системы, токены, компоненты и документацию через 10 генераторов. Проводит от брифа до кода экранов. CX Codex +1 ★ 141звёзд репо substack-expert Скилл substack-expert помогает готовить Substack-публикации: выстраивает структуру, SEO-метаданные, вовлечение и путь от бесплатной подписки к платной. CX Codex +1 ★ 141звёзд репо pier-cloud Скилл для работы с API Pier Cloud (Lighthouse): JWT-авторизация, контексты, воркспейсы и данные FinOps через готовые Python-скрипты. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой