Gravity UI теперь agent-ready: встречайте llms.txt и скилл Gravity UI
Gravity UI теперь agent-ready: встречайте llms.txt и скилл Gravity UI
llms.txt — каталог всех 34 пакетов Gravity UI для AI-агентов с версионированной документацией по каждому пакету. Open-source-скилл Gravity UI помогает агентам выбирать правильные пакеты и актуальные API.
Всё большая доля UI-кода пишется не руками, а AI-агентами. И это обнажило проблему: в Gravity UI больше 30 пакетов, и агенты начинают угадывать. Они берут @gravity-ui/chartkit, когда нужен @gravity-ui/charts, используют встроенный Table из uikit там, где уместен отдельный @gravity-ui/table, опираются на устаревшие API или просто выдумывают пропсы и имена иконок.
Сегодня мы выпускаем две вещи, которые превращают угадывание в знание.
llms.txt: карта Gravity UI для агентов
gravity-ui.com/llms.txt — компактный каталог всех 34 пакетов Gravity UI, адресованный агентам. Для каждого пакета он объясняет, зачем тот нужен, и — что не менее важно — когда его использовать не стоит и что взять вместо него.
Из каталога агенты могут провалиться в документацию по конкретному пакету, и она версионирована:
/llms/<package>/llms.txt— последняя версия/llms/<package>/<major>/llms.txt— последняя в рамках мажорной линейки/llms/<package>/<version>/llms.txt— конкретная версия
Каталог прямо говорит агенту: сначала прочитай package.json проекта и ориентируйся на установленные версии. Несовпадение peer-версий — самая частая ошибка, которую мы видим в коде, написанном агентами.
Если ваш инструмент уже понимает llms.txt, настраивать ничего не нужно. Если нет — просто дайте агенту ссылку.
Скилл Gravity UI: меньше неверных поворотов
Для агентов, поддерживающих открытый формат скиллов, мы также выпустили скилл:
npx skills add gravity-ui/skills
Он устанавливается в Claude Code, Cursor, Codex, GitHub Copilot и ещё 70+ агентов. Скилл помогает агенту выбирать правильный пакет, использовать актуальные API компонентов и настоящие имена иконок, корректно работать с импортами @gravity-ui/*, настройкой ThemeProvider и CSS-токенами --g-* — в типовых задачах вроде дашбордов, таблиц с данными, графиков и форм.
Скилл открыт под лицензией MIT: github.com/gravity-ui/skills
Попробуйте и расскажите, что сломалось
Установите скилл, дайте агенту ссылку на llms.txt и позвольте ему собрать что-то настоящее. Если агент всё ещё ошибается — это баг в нашей документации, и мы хотим о нём знать: issues и PR приветствуются в репозитории скилла.