Gravity UI ahora es agent-ready: conoce llms.txt y el skill de Gravity UI
Gravity UI ahora es agent-ready: conoce llms.txt y el skill de Gravity UI
llms.txt es un catálogo de los 34 paquetes de Gravity UI orientado a agentes de IA, con documentación versionada por paquete. El skill open source ayuda a los agentes de código a elegir el paquete correcto y usar APIs actuales.
Una parte cada vez mayor del código de UI no se escribe a mano, sino con agentes de codificación con IA. Y eso dejó al descubierto un problema: con más de 30 paquetes en Gravity UI, los agentes tienden a adivinar. Eligen @gravity-ui/chartkit cuando necesitan @gravity-ui/charts, usan la Table integrada de uikit donde corresponde el paquete independiente @gravity-ui/table, se apoyan en APIs obsoletas o directamente inventan props y nombres de iconos.
Hoy lanzamos dos cosas que convierten las conjeturas en conocimiento.
llms.txt: un mapa de Gravity UI para agentes
gravity-ui.com/llms.txt es un catálogo compacto, orientado a agentes, de los 34 paquetes de Gravity UI. Para cada uno explica para qué sirve el paquete y, igual de importante, cuándo no usarlo y qué elegir en su lugar.
Desde el catálogo, los agentes pueden profundizar en la documentación de cada paquete, y esa documentación está versionada:
/llms/<package>/llms.txt— la más reciente/llms/<package>/<major>/llms.txt— la más reciente dentro de una línea major/llms/<package>/<version>/llms.txt— versión exacta
El catálogo indica explícitamente a los agentes que lean primero tu package.json y se ajusten a las versiones instaladas. Los desajustes de peer-versions son el modo de fallo más común que vemos en el código generado por agentes.
Si tu herramienta ya entiende llms.txt, no hay nada que configurar. Si no, simplemente apunta tu agente a la URL.
El skill de Gravity UI: menos giros equivocados
Para los agentes que soportan el formato abierto de skills, también publicamos un skill:
npx skills add gravity-ui/skills
Se instala en Claude Code, Cursor, Codex, GitHub Copilot y más de 70 agentes más. El skill ayuda al agente a elegir el paquete correcto, usar las APIs actuales de los componentes y nombres reales de iconos, y manejar correctamente los imports @gravity-ui/*, la configuración de ThemeProvider y los design tokens CSS --g-*, en tareas típicas como dashboards, tablas de datos, gráficos y formularios.
El skill es open source bajo licencia MIT: github.com/gravity-ui/skills
Pruébalo y cuéntanos qué falla
Instala el skill, apunta tu agente a llms.txt y deja que construya algo real. Si el agente todavía se equivoca en algo, es un bug en nuestra documentación y queremos saberlo: los issues y PRs son bienvenidos en el repositorio de skills.