agntcy-dir

agntcy-dir — официальный скилл AGNTCY для работы с распределённым реестром AI-агентов и связанных ресурсов через dirctl. AGNTCY Directory описан как peer-to-peer registry, где записи OASF содержат навыки, домены, модули, locators, подписи и результаты security scan. Записи адресуются content identifier, или CID: одинаковые байты дают тот же CID, а любое изменение создаёт новый. Внутри записи модуль может описывать MCP-сервер, A2A-карточку или Agent Skill, а locator указывает на запускаемый артефакт вроде исходного кода, Docker-образа или Helm chart. Скилл полезен, когда нужно не просто найти название инструмента, а работать с реестром и его структурированными записями. Это маршрутизатор, поэтому перед действием выбирается соответствующая reference-инструкция. Для установки dirctl, локального каталога, daemon, contexts и проблем соединения читается references/setup.md. Создание или проверка OASF-записи и импорт MCP, A2A или skills относятся к references/authoring.md. Push, публикация, подпись и подтверждение владения именем — к publishing.md. Поиск, browse, suggest и pull используют discovery.md; проверка подписи, принадлежности имени и security scan — verification.md; зеркалирование и синхронизация — sync.md; установка или удаление записи в редакторе и экспорт в mcp.json, SKILL.md или A2A card — install.md. Если запрос охватывает несколько операций, источник разрешает прочитать несколько reference-файлов, например authoring вместе с publishing. Перед командами нужно проверить наличие dirctl в PATH через dirctl version или command -v dirctl. Для большинства операций требуется доступный Directory server; по умолчанию используется localhost:8888. Выбор сервера идёт в порядке --context, переменной DIRECTORY_CLIENT_CONTEXT, current_context в конфигурации, затем --server-addr или DIRECTORY_CLIENT_SERVER_ADDRESS. Это важное ограничение: команды context, validate, install list и version могут работать без сервера, тогда как поиск, публикация и синхронизация зависят от соединения и авторизации. Скилл поддерживает macOS, Linux и Windows с отличиями в упаковке, но команды следует адаптировать под реальную оболочку, а не копировать bash-синтаксис в PowerShell. Для автоматизации рекомендуется запрашивать структурированный вывод -o json или -o jsonl, а -o raw оставлять для CID в shell-пайплайнах. Сообщения и JSON разделены по stdout и stderr, поэтому результат можно безопасно передавать в jq. Имена записей всегда нужно заключать в кавычки: в них могут встречаться / и :. Перед использованием новых команд стоит открыть dirctl <command> --help, потому что набор возможностей меняется между версиями. Скилл запрещает придумывать CID, имена, версии, оценки или результаты сканирования: каждое значение должно прийти из фактического вывода. Auth-флаги нельзя угадывать; при ошибке авторизации надо показать исходную ошибку и выбрать документированный способ входа. Безопасность операционного workflow задаётся явными границами. Destructive-команды delete, uninstall, sync delete и --force требуют подтверждения. Длинные init, import и sync могут занимать минуты, поэтому о них нужно предупредить и показывать прогресс. В headless или CI-запуске нельзя зависать на вопросах: для поддержанных операций используются --yes, переменная DIRECTORY_CLIENT_AUTH_TOKEN или документированный device/no-browser flow, а решение, требующее человека, завершается понятным сообщением. Встроенный dirctl mcp serve может предоставить MCP-интерфейс для push, pull, search, validate и taxonomy browsing; конфигурацию следует объединять, не затирая существующие серверы. Карточка описывает проверяемый CLI-маршрут, но наличие записи, подписи или scan report не следует превращать в выдуманное обещание безопасности: сначала прочитайте соответствующую reference и опирайтесь только на реальные ответы Directory.