Comments 2
Спасибо за то, что делитесь опытом.
Как себя ведут агенты, если, например, в пакете в README.md указать ссылку на локальный SKILL.MD/AGENTS.MD/AI_DOCS.md? Или именование файла настолько важно?
Я заметил, что этот способ годен для ИИ, когда они гуглят информацию о библиотеке: находят ссылку на npm/github, далее читают README, по ссылкам доки/скиллы.
Спасибо на добром слове, коллега :)
.agents/skills/ - это соглашение о нахождении навыков для OpenAI (я работаю с Codex'ом, в основном).
~/.agents/skills/{skill-name}/SKILL.md- навыки пользователя.agents/skills/{skill-name}/SKILL.md- навыки проекта
.agents/ - это попытка унификации нахождения места для навыков между различными вендорами. В эту сторону двигаются Codex, Gemini, GitHubCopilot, OpenCode, Replit, Windsurf, ... Claude Code придерживается наименования .claude/ .
То есть, можно в проекте иметь два каталога для проектных скиллов (.agents/ и .claude/) и просто ставить симлинки на соответствующим образом оформленные навыки в зависимостях из обоих каталогов.
Одного этого уже достаточно, чтобы агенты в принципе могли использовать эти навыки. Это их образ действия.
README.md - это для людей, в первую очередь. Агент тоже может читать README.md, но читает в первую очередь AGENTS.md. Я сейчас говорю не за поиск в интернете, а за доставку skill-инструкций в зависимостях прямо в приложение.
Например, у меня в проекте mindstream навыки проекта выглядят так:
В проекте есть один "свой" навык - соглашения по проекту и 6 ссылок на навыки зависимостей. Все ссылочные зависимости поставляются в составе npm-пакета через npm-реестр:
Не обязательно линковать все навыки зависимостей, достаточно только тех, которые нужны для разработки проекта.
Agent Skills в npm-пакетах: доставка агенту знаний о библиотеке