Gravity UI est désormais agent-ready: voici llms.txt et le skill Gravity UI

Une part croissante du code d’interface n’est plus écrite à la main, mais par des agents de codage IA. Et cela a révélé un problème: avec plus de 30 paquets dans Gravity UI, les agents ont tendance à deviner. Ils choisissent @gravity-ui/chartkit quand il leur faut @gravity-ui/charts, utilisent la Table intégrée d’uikit là où le paquet autonome @gravity-ui/table s’impose, s’appuient sur des API obsolètes ou inventent tout simplement des props et des noms d’icônes.

Aujourd’hui, nous publions deux choses qui transforment la devinette en connaissance.

llms.txt: une carte de Gravity UI pour les agents

gravity-ui.com/llms.txt est un catalogue compact des 34 paquets Gravity UI, destiné aux agents. Pour chacun, il explique à quoi sert le paquet et, tout aussi important, quand il ne faut pas l’utiliser et quoi choisir à la place.

Depuis le catalogue, les agents peuvent descendre dans la documentation de chaque paquet, et celle-ci est versionnée:

• /llms/<package>/llms.txt — dernière version
• /llms/<package>/<major>/llms.txt — dernière version d’une ligne majeure
• /llms/<package>/<version>/llms.txt — version exacte

Le catalogue dit explicitement aux agents de lire d’abord votre package.json et de s’aligner sur les versions installées. Les incompatibilités de peer-versions sont le mode d'échec le plus courant que nous observons dans le code généré par des agents.

Si votre outil comprend déjà llms.txt, il n’y a rien à configurer. Sinon, il suffit de pointer votre agent vers l’URL.

Le skill Gravity UI: moins de mauvais choix

Pour les agents qui prennent en charge le format ouvert de skills, nous avons aussi publié un skill:

npx skills add gravity-ui/skills

Il s’installe dans Claude Code, Cursor, Codex, GitHub Copilot et plus de 70 autres agents. Le skill aide l’agent à choisir le bon paquet, à utiliser les API actuelles des composants et de vrais noms d’icônes, et à gérer correctement les imports @gravity-ui/*, la configuration de ThemeProvider et les design tokens CSS --g-*, pour des tâches typiques comme les dashboards, les tableaux de données, les graphiques et les formulaires.

Le skill est open source sous licence MIT: github.com/gravity-ui/skills

Essayez-le et dites-nous ce qui casse

Installez le skill, pointez votre agent vers llms.txt et laissez-le construire quelque chose de réel. Si l’agent se trompe encore, c’est un bug dans notre documentation, et nous voulons le savoir: issues et PR sont les bienvenus dans le dépôt skills.