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

agent-ready-api-catalog — скилл Claude Code: обзор и запуск

Скилл agent-ready-api-catalog помогает развернуть каталог API по стандарту RFC 9727 для автоматического обнаружения эндпоинтов ИИ-агентами.

Apache-2.0 ★ 141 обновлён 2026-10-29

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

Что делает agent-ready-api-catalog

Скилл настраивает отдачу каталога по адресу /.well-known/api-catalog. Ответ сервера отдаётся со статусом HTTP 200 и заголовком Content-Type: application/linkset+json. Внутри формируется массив linkset, где для каждого интерфейса прописывается базовый URL anchor вместе со связями service-desc для спецификации OpenAPI и service-doc для документации. При необходимости добавляется эндпоинт проверки здоровья через отношение status.

Проверить корректность настройки можно внешним запросом через POST к https://isitagentready.com/api/scan. Без заголовка application/linkset+json сканер выдаст ошибку валидации.

Какие задачи решает

  • опубликовать эндпоинт /.well-known/api-catalog по RFC 9727
  • связать спецификацию OpenAPI и документацию через linkset
  • проверить готовность API к автоматическому обнаружению агентами

Примеры запросов агенту

  • Настрой каталог API по стандарту RFC 9727 для нашего сервиса
  • Сформируй эндпоинт /.well-known/api-catalog со ссылкой на OpenAPI и документацию
  • Проверь через сканер isitagentready.com, проходит ли каталог валидацию

Как установить agent-ready-api-catalog

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-api-catalog -a claude-code

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

~/.claude/skills/api-catalog/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об agent-ready-api-catalog

Как установить agent-ready-api-catalog в Claude Code?

Выполните команду npx skills add fabricioctelles/skills --skill api-catalog -a claude-code. Файл конфигурации сохранится в ~/.claude/skills/api-catalog/SKILL.md.

Что делает этот скилл?

Он помогает внедрить каталог API по стандарту RFC 9727, чтобы внешние ИИ-агенты могли автоматически находить документацию и спецификации сервиса.

Какие поля обязательны в каталоге?

В массиве linkset для каждой записи нужны URL anchor, ссылка на OpenAPI в service-desc и адрес документации в service-doc.

Исходный текст

SKILL.md · Apache-2.0
---
name: agent-ready-api-catalog
description: >
  Sub-skill de agent-ready-cloudflare: Implement API Catalog
---
# Implement API Catalog

Publish an API catalog for automated discovery per
[RFC 9727](https://www.rfc-editor.org/rfc/rfc9727).

## Requirements

- Serve `/.well-known/api-catalog` with `Content-Type: application/linkset+json` and HTTP 200
- Include a `linkset` array with entries for each API
- Each entry needs an `anchor` URL and link relations: `service-desc` (OpenAPI spec), `service-doc` (docs), and optionally `status` (health endpoint)
- See [RFC 9727 Appendix A](https://www.rfc-editor.org/rfc/rfc9727#appendix-A) for examples

## Validate

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

{"url": "https://YOUR-SITE.com"}
```

Check that `checks.discovery.apiCatalog.status` is `"pass"`.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

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

Все скиллы по теме «Бэкенд и API» →
minimal-api codewithmukesh Учит генерировать HTTP-эндпоинты на .NET 10 по паттернам Minimal API. Подключается автоматически, когда в запросе встречается «endpoint», MapGet, MapGroup или «OpenAPI». CX Codex +1 4 000установок rest-api-design aj-geddes Скилл rest-api-design задаёт правила именования ресурсов, HTTP-методов, кодов ответа и версионирования, когда вы проектируете новые эндпоинты или переделываете старые. CX Codex +1 2 100установок browser-to-api browserbase Скилл browser-to-api для Claude Code и Codex. Разбирает запись браузерной сессии и собирает из неё спецификацию OpenAPI 3.1, клиент на fetch и отчёт о покрытии API, когда документация не опубликована. CX Codex +1 2 000установок api-design-patterns agent-skills Скилл api-design-patterns для Claude Code с 38 правилами проектирования REST API: ресурсы, ошибки, безопасность, пагинация, версионирование. Помогает агенту писать и проверять эндпоинты по единым стандартам. CX Codex +1 1 000установок api-docs ruvnet Скилл api-docs собирает документацию по исходникам на TypeScript и JavaScript: находит публичные экспорты, разбирает JSDoc, дописывает недостающие комментарии и выдаёт OpenAPI 3.0 для HTTP-эндпоинтов. CX Codex +1 893установок inngest-api inngest Скилл inngest-api инструктирует агента по работе с REST API v2 Inngest через прямые HTTP-запросы, спецификацию OpenAPI и документацию, когда возможностей CLI или MCP недостаточно. CX Codex +1 870установок

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

Весь набор →
agent-ready-llms-txt Скилл agent-ready-llms-txt для Claude Code подготавливает файл /llms.txt на сайте с описанием структуры и содержания проекта для агентов и ИИ-моделей. CX Codex +1 ★ 141звёзд репо agent-ready-x402 Скилл agent-ready-x402 настраивает приём платежей по протоколу x402 для автономных агентов. Помогает внедрить мидлвар на Express, Hono или Next.js и отдавать код HTTP 402. CX Codex +1 ★ 141звёзд репо agent-ready-acp Скилл agent-ready-acp помогает опубликовать ACP discovery document, чтобы AI-агенты находили реализацию Agentic Commerce Protocol. CX Codex +1 ★ 141звёзд репо agent-ready-robots-txt Скилл agent-ready-robots-txt для Claude Code настраивает корректный по RFC 9309 robots.txt в корне сайта. Файл задаёт правила доступа ботов к контенту и ссылается на карту сайта, если она есть. CX Codex +1 ★ 141звёзд репо agent-ready-content-signals Скилл agent-ready-content-signals добавляет Content Signals в robots.txt, чтобы задать правила для AI-тренировки, поиска и передачи контента в AI. CX Codex +1 ★ 141звёзд репо agent-ready-mcp-server-card Скилл agent-ready-mcp-server-card для Claude Code помогает опубликовать MCP Server Card — JSON-файл для обнаружения MCP-сервера агентами. Задача — сделать развёрнутый MCP-сервер доступным для обнаружения. CX Codex +1 ★ 141звёзд репо agent-ready-a2a-agent-card Скилл agent-ready-a2a-agent-card для Claude Code настраивает карточку агента по протоколу A2A и публикует /.well-known/agent-card.json. Это позволяет другим агентам обнаруживать сервис. CX Codex +1 ★ 141звёзд репо agent-ready-web-bot-auth Скилл agent-ready-web-bot-auth для Claude Code описывает настройку Web Bot Auth, чтобы сайты проверяли подписи запросов ботов и агентов. Настройка включает публикацию JWKS и подпись исходящих запросов. CX Codex +1 ★ 141звёзд репо

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

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