Gravity UI agora é agent-ready: conheça o llms.txt e o skill do Gravity UI
Gravity UI agora é agent-ready: conheça o llms.txt e o skill do Gravity UI
O llms.txt é um catálogo dos 34 pacotes do Gravity UI voltado para agentes de IA, com documentação versionada por pacote. O skill open source ajuda agentes de código a escolher o pacote certo e usar APIs atuais.
Uma parcela cada vez maior do código de UI não é escrita à mão, mas por agentes de codificação com IA. E isso expôs um problema: com mais de 30 pacotes no Gravity UI, os agentes tendem a adivinhar. Eles escolhem @gravity-ui/chartkit quando precisam de @gravity-ui/charts, usam a Table embutida do uikit onde o pacote independente @gravity-ui/table seria o certo, dependem de APIs desatualizadas ou simplesmente inventam props e nomes de ícones.
Hoje estamos lançando duas coisas que transformam adivinhação em conhecimento.
llms.txt: um mapa do Gravity UI para agentes
O gravity-ui.com/llms.txt é um catálogo compacto, voltado para agentes, de todos os 34 pacotes do Gravity UI. Para cada um, ele explica para que o pacote serve e, igualmente importante, quando não usá-lo e o que escolher no lugar.
A partir do catálogo, os agentes podem se aprofundar na documentação de cada pacote, e ela é versionada:
/llms/<package>/llms.txt— mais recente/llms/<package>/<major>/llms.txt— mais recente dentro de uma linha major/llms/<package>/<version>/llms.txt— versão exata
O catálogo instrui explicitamente os agentes a ler primeiro o seu package.json e seguir as versões instaladas. Incompatibilidades de peer-versions são o modo de falha mais comum que vemos em código gerado por agentes.
Se a sua ferramenta já entende llms.txt, não há nada para configurar. Se não, basta apontar seu agente para a URL.
O skill do Gravity UI: menos erros de caminho
Para agentes que suportam o formato aberto de skills, também lançamos um skill:
npx skills add gravity-ui/skills
Ele se instala no Claude Code, Cursor, Codex, GitHub Copilot e em mais de 70 outros agentes. O skill ajuda o agente a escolher o pacote correto, usar as APIs atuais dos componentes e nomes reais de ícones, e lidar corretamente com imports @gravity-ui/*, configuração do ThemeProvider e design tokens CSS --g-*, em tarefas típicas como dashboards, tabelas de dados, gráficos e formulários.
O skill é open source sob licença MIT: github.com/gravity-ui/skills
Experimente e conte o que quebrou
Instale o skill, aponte seu agente para o llms.txt e deixe-o construir algo de verdade. Se o agente ainda errar em algo, isso é um bug na nossa documentação e queremos saber: issues e PRs são bem-vindos no repositório de skills.