Gravity UI Is Now Agent-Ready: Meet llms.txt and the Gravity UI Skill
Gravity UI Is Now Agent-Ready: Meet llms.txt and the Gravity UI Skill
llms.txt is an agent-facing catalog of all 34 Gravity UI packages with versioned per-package docs. The open-source Gravity UI skill helps coding agents pick the right package and use current APIs.
A growing share of UI code is written not by hand, but by AI coding agents. And that exposed a problem: with 30+ packages in Gravity UI, agents tend to guess. They pick @gravity-ui/chartkit when they need @gravity-ui/charts, use uikit’s built-in Table where the standalone @gravity-ui/table belongs, rely on outdated APIs, or simply invent props and icon names.
Today we’re shipping two things that turn guessing into knowing.
llms.txt: a map of Gravity UI for agents
gravity-ui.com/llms.txt is a compact, agent-facing catalog of all 34 Gravity UI packages. For each one it explains what the package is for and, just as importantly, when not to use it and what to reach for instead.
From the catalog, agents can drill down into per-package docs, and those are versioned:
/llms/<package>/llms.txt— latest/llms/<package>/<major>/llms.txt— latest within a major line/llms/<package>/<version>/llms.txt— exact version
The catalog explicitly tells agents to read your package.json first and match the installed versions. Peer-version mismatches are the most common failure mode we see in agent-generated code.
If your tool already understands llms.txt, there’s nothing to configure. If not, just point your agent at the URL.
The Gravity UI skill: fewer wrong turns
For agents that support the open skills format, we also released a skill:
npx skills add gravity-ui/skills
It installs into Claude Code, Cursor, Codex, GitHub Copilot and 70+ other agents. The skill helps the agent choose the correct package, use current component APIs and real icon names, and handle @gravity-ui/* imports, ThemeProvider setup and --g-* CSS design tokens correctly, across typical tasks like dashboards, data tables, charts and forms.
The skill is open source under MIT: github.com/gravity-ui/skills
Try it and tell us what breaks
Install the skill, point your agent at llms.txt, and let it build something real. If the agent still gets something wrong, that’s a bug in our docs and we want to know about it. Issues and PRs are welcome in the skills repo.