Agent Skills

NEW

Sin esto, tu agente escribe markup con Tailwind crudo y reinventa componentes que ya tenés instalados. La Skill le enseña el catálogo, los tokens semánticos y las reglas que no puede adivinar leyendo el código.

Instalación

npx orbitui-cli agents

Te pregunta dónde escribirla. Con --all escribe en los tres destinos sin preguntar. orbit-ui init ya la instala por defecto, así que en un proyecto nuevo no hace falta correr nada más.

Destino	Para
`.claude/skills/orbit-ui/SKILL.md`	Claude Code
`AGENTS.md`	Cualquier agente que lea el repositorio
`.cursor/rules/orbit-ui.mdc`	Cursor

En AGENTS.md el contenido va entre marcadores  y . Volver a correr el comando reemplaza solo esa sección y conserva lo que hayas escrito vos.

Qué contiene

Se genera desde el mismo registry que alimenta esta documentación y el CLI, así que el catálogo siempre refleja los 58 componentes reales. Escribirla a mano garantizaría que quede desactualizada en la primera semana.

El catálogo completo
Nombre, para qué sirve y de qué depende cada componente
La tabla de tokens
Qué clase usar para cada superficie, texto, borde y estado
Las utilidades tipográficas
Para que no reconstruya la escala apilando clases
Las reglas de composición
Seis cosas que no se deducen leyendo el código

Las reglas que enseña

Estas son las que un agente no puede inferir, y las que más veces rompe cuando no las tiene:

Solo tokens semánticos
Nunca bg-white ni text-gray-500. Las primitivas viven fuera de @theme y no generan utilidades a propósito: si escribió bg-orbit-… y no anda, no es un bug.
Ninguna animación puede ser condición para ver el dato
El estado de reposo tiene que ser el valor final. Un requestAnimationFrame no corre en pestañas ocultas y deja el elemento vacío para siempre.
El estado se comunica con forma además de color
Un tilde y una cruz se distinguen; verde y rojo, no siempre.
Combinar clases con cx(), nunca concatenando
Resuelve conflictos de Tailwind, así que la prop className del consumidor siempre gana.
Extender el componente instalado, no volver al HTML crudo
Los interactivos se apoyan en React Aria: volver a un <button> pelado tira toda la accesibilidad.
No reimplementar un componente Pro para esquivar el gate
Si falta la licencia, avisarle al usuario en vez de escribir una copia a mano.

Verla antes de instalarla

La skill se sirve como texto plano. Podés leerla, versionarla o pegarla en cualquier agente a mano:

curl https://componentespremiums.vercel.app/skill

Skill, MCP y llms.txt

Son tres superficies para tres audiencias, y se complementan. La Skill fija las convenciones sin red; el MCP responde qué hay y puede instalar; llms.txt sirve la documentación en texto plano a cualquier LLM que fetchee la URL, sin configurar nada.

	Skill	MCP	llms.txt
Dónde vive	Tu repositorio	Lo corre el agente	Nuestro servidor
Setup	Un comando	Configuración	Ninguno
Siempre al día	Al regenerarla	Sí	Sí
Puede instalar	No	Sí	No
Sin red	Sí	No	No