agent-ready-dns-aid — скилл для Claude Code: DNS-AID и установка
Скилл agent-ready-dns-aid для Claude Code публикует DNS-AID-записи, чтобы агенты находили endpoint через DNS. Настраивает SVCB или HTTPS-записи в пространстве _agents.
Apache-2.0 ★ 141 обновлён 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-dns-aid -a claude-codeЧто делает agent-ready-dns-aid
Скилл описывает настройку DNS for AI Discovery: записи размещаются в пространстве имён _agents, например _a2a._agents.example.com. Для endpoint используются записи ServiceMode SVCB, а для HTTPS можно выбрать HTTPS; в них задаются alpn и параметры подключения. Экспериментальные параметры получают числовые имена keyNNNNN до регистрации.
Публичные зоны discovery нужно подписывать DNSSEC, иначе validating resolver не вернёт аутентифицированные данные. Проверка выполняется через DNS-over-HTTPS: сканер по умолчанию обращается к https://cloudflare-dns.com/dns-query и переключается на https://dns.google/resolve при ошибке уровня резолвера. В библиотечном вызове резолвер задаётся через ScanOptions.dohResolverUrl, что отключает fallback.
После публикации запись можно проверить через https://isitagentready.com/api/scan, передав URL сайта. Успешным считается статус checks.discoverability.dnsAid.status со значением "pass". Без DNSSEC зона не выполнит это требование.
Какие задачи решает
- опубликовать endpoint в DNS для обнаружения агентами
- настроить SVCB-запись под
_agents - задать
alpn, порт и параметры подключения - подписать discovery-зону через DNSSEC
- проверить DNS-AID через DNS-over-HTTPS
Примеры запросов агенту
- Настрой DNS-AID для моего endpoint через пространство имён
_agents, добавьalpnи параметры подключения. - Составь SVCB-запись для A2A endpoint и проверь её через
https://isitagentready.com/api/scan. - Проверь, что DNS-зона подписана DNSSEC и статус
checks.discoverability.dnsAid.statusравен"pass".
Как установить agent-ready-dns-aid
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-dns-aid -a claude-code2Вручную: положить файлы
~/.claude/skills/dns-aid/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/dns-aid/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-dns-aid -a codex2Вручную: положить файлы
.agents/skills/dns-aid/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-dns-aid -a cursor2Вручную: положить файлы
.cursor/skills/dns-aid/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/dns-aid2Вручную: положить файлы
.github/skills/dns-aid/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-dns-aid -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/dns-aidВручную: положить файлы
.devin/skills/dns-aid/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об agent-ready-dns-aid
Как установить agent-ready-dns-aid в Claude Code?
Выполните npx skills add fabricioctelles/skills --skill dns-aid -a claude-code, затем используйте скилл из ~/.claude/skills/dns-aid/SKILL.md.
Что делает agent-ready-dns-aid?
Скилл помогает настроить DNS-AID-записи под _agents, чтобы агенты находили endpoint через DNS. Он охватывает записи SVCB и HTTPS, параметры alpn, подключение и проверку через DNS-over-HTTPS.
Зачем подписывать DNS-AID-зону через DNSSEC?
DNSSEC нужен для аутентификации данных discovery: validating resolver должен вернуть подписанные DNS-данные.
Исходный текст
SKILL.md · Apache-2.0
---
name: agent-ready-dns-aid
description: >
Sub-skill: Implement DNS-AID records so agents discover endpoints through DNS.
Use SVCB/HTTPS records under _agents namespace with alpn and connection parameters.
---
# Implement DNS for AI Discovery (DNS-AID)
Publish DNS for AI Discovery (DNS-AID) records so agents can discover your agent endpoints through DNS.
## Requirements
- Publish DNS for AI Discovery (DNS-AID) records under your domain's `_agents` namespace, such as `_index._agents.example.com` or `_a2a._agents.example.com`
- Use ServiceMode `SVCB` records, or `HTTPS` records for HTTPS endpoints, with `alpn` and endpoint connection parameters
- Use numeric `keyNNNNN` SvcParamKey names for experimental DNS for AI Discovery (DNS-AID) custom parameters until they are registered
- Sign public DNS for AI Discovery (DNS-AID) discovery zones with DNSSEC so validating resolvers return authenticated data
## Example
```dns
_a2a._agents.example.com. 3600 IN SVCB 1 agent.example.com. alpn="a2a" port=443 mandatory=alpn,port
```
## Validate
The scanner validates DNS for AI Discovery (DNS-AID) via DNS-over-HTTPS. By default, the scanner uses Cloudflare's `https://cloudflare-dns.com/dns-query` with automatic fallback to `https://dns.google/resolve` on resolver-level failures. Library callers can override the resolver with `ScanOptions.dohResolverUrl` (disables fallback).
```http
POST https://isitagentready.com/api/scan
Content-Type: application/json
{"url": "https://YOUR-SITE.com"}
```
Check that `checks.discoverability.dnsAid.status` is `"pass"`.
## References
- [draft-mozleywilliams-dnsop-dnsaid](https://datatracker.ietf.org/doc/draft-mozleywilliams-dnsop-dnsaid/)
- [RFC 9460 — SVCB and HTTPS Resource Records](https://www.rfc-editor.org/info/rfc9460)
© fabricioctelles · Apache-2.0 · fabricioctelles/skills