agent-ready-api-catalog — скилл Claude Code: обзор и запуск
Скилл agent-ready-api-catalog помогает развернуть каталог API по стандарту RFC 9727 для автоматического обнаружения эндпоинтов ИИ-агентами.
Apache-2.0 ★ 141 обновлён 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-api-catalog -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/api-catalog/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-catalog/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-api-catalog -a codex2Вручную: положить файлы
.agents/skills/api-catalog/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-api-catalog -a cursor2Вручную: положить файлы
.cursor/skills/api-catalog/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/api-catalog2Вручную: положить файлы
.github/skills/api-catalog/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-api-catalog -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/api-catalogВручную: положить файлы
.devin/skills/api-catalog/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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