Gravity UI, 이제 agent-ready: llms.txt와 Gravity UI 스킬을 소개합니다

UI 코드에서 점점 더 많은 부분이 사람 손이 아니라 AI 코딩 에이전트에 의해 작성되고 있습니다. 그러면서 한 가지 문제가 드러났습니다. Gravity UI에는 30개가 넘는 패키지가 있고, 에이전트는 추측에 의존하곤 합니다. @gravity-ui/charts가 필요한 자리에 @gravity-ui/chartkit을 고르고, 독립 패키지 @gravity-ui/table을 써야 할 곳에 uikit 내장 Table을 사용하고, 오래된 API에 의존하거나, 존재하지 않는 props와 아이콘 이름을 지어내기도 합니다.

오늘 우리는 추측을 지식으로 바꾸는 두 가지를 출시합니다.

llms.txt: 에이전트를 위한 Gravity UI 지도

gravity-ui.com/llms.txt는 Gravity UI의 전체 34개 패키지를 담은, 에이전트를 위한 간결한 카탈로그입니다. 각 패키지에 대해 어떤 용도인지, 그리고 그만큼 중요하게 언제 사용하지 말아야 하는지와 대신 무엇을 선택해야 하는지를 설명합니다.

카탈로그에서 에이전트는 패키지별 문서로 내려갈 수 있으며, 문서는 버전별로 제공됩니다:

• /llms/<package>/llms.txt — 최신 버전
• /llms/<package>/<major>/llms.txt — 해당 메이저 라인의 최신 버전
• /llms/<package>/<version>/llms.txt — 특정 버전

카탈로그는 에이전트에게 먼저 프로젝트의 package.json을 읽고 설치된 버전에 맞추라고 명시적으로 지시합니다. peer 버전 불일치는 에이전트가 생성한 코드에서 가장 흔히 보이는 실패 유형입니다.

사용 중인 도구가 이미 llms.txt를 이해한다면 따로 설정할 것이 없습니다. 그렇지 않다면 에이전트에게 URL만 알려주면 됩니다.

Gravity UI 스킬: 잘못된 선택 줄이기

열린 스킬 형식을 지원하는 에이전트를 위해 스킬도 출시했습니다:

npx skills add gravity-ui/skills

Claude Code, Cursor, Codex, GitHub Copilot을 비롯한 70개 이상의 에이전트에 설치할 수 있습니다. 스킬은 에이전트가 올바른 패키지를 선택하고, 최신 컴포넌트 API와 실제 아이콘 이름을 사용하고, @gravity-ui/* import, ThemeProvider 설정, --g-* CSS 디자인 토큰을 올바르게 다루도록 돕습니다. 대시보드, 데이터 테이블, 차트, 폼 같은 전형적인 작업에서 유용합니다.

스킬은 MIT 라이선스 오픈소스입니다: github.com/gravity-ui/skills

직접 써보고 문제를 알려주세요

스킬을 설치하고, 에이전트에 llms.txt를 알려준 뒤, 실제로 무언가를 만들게 해보세요. 그래도 에이전트가 틀린다면 그것은 우리 문서의 버그이고, 우리는 그것을 알고 싶습니다. skills 저장소에 issue와 PR을 환영합니다.