Gravity UI skills for AI Agents

Agent Skills for building with Gravity UI ecosystem. Compatible with other agents as well via skills.sh.

Install

npx skills add gravity-ui/skills

Available skills

gravity-ui

Builds, fixes, styles, and composes UI with Gravity UI. Gravity UI is a 30+-package design system. AI agents get three things wrong:

1. Pick the wrong package — charts vs chartkit, uikit Table vs @gravity-ui/table, date-components vs date-utils.
2. Use outdated APIs — training data lags the installed version; the agent writes props that don't exist (anymore, or yet).
3. Invent component APIs / icon names — Button variant=, Icon name=, guessed @gravity-ui/icons names, Text variant="header-3".

This skill fixes all three.

Use when:

• Working with @gravity-ui/* imports, uikit, ThemeProvider, or --g- CSS tokens.
• Building dashboards, tables, charts, forms, navigation shells, or landing pages on Gravity UI.
• Any prompt (EN or RU) mentioning gravity-ui, гравити, дизайн-система, компоненты, дашборд, таблица, график, or форма.

gravity-ui-v8-migration

Upgrades @gravity-ui/uikit from v7 to v8 in an app or a library. The migration guides ship inside the v8 package; the skill adds what they leave to the agent:

1. Preflight — React 18+, and the third-party dependencies that still pin uikit v7 (scripts/check-uikit-peers.mjs).
2. Inventory and decisions — the affected code grouped by guide section, and the choices that belong to the user: /legacy or a rewrite, the l breakpoint.
3. Verification past tsc — many v8 changes compile cleanly and show only on screen or in tests.

Use when: bumping uikit to 8, estimating that upgrade, or finishing a half-done one.

Activation tip

Skill auto-activation across agents sits around ~50% in public evals — the skill exists, the agent just doesn't always invoke it.

Paste this into your AGENTS.md:

<!-- BEGIN:gravity-ui-agent-rules -->
# Gravity UI

This project uses the Gravity UI design system (`@gravity-ui/*`). Before writing
or modifying Gravity UI component code, you **MUST invoke the `gravity-ui`
skill** — it routes you to the correct package and prevents invented APIs. Run
it on any UI task here.
<!-- END:gravity-ui-agent-rules -->

For Claude Code, also add @AGENTS.md to CLAUDE.md (it reads CLAUDE.md natively, not AGENTS.md).

License

Distributed under the MIT License. See LICENSE for details.