Para agentes y herramientas
Un asistente de código que no conoce la biblioteca se inventa las props. Para que no tenga que adivinar, el paquete se describe a sí mismo en ficheros que una máquina lee, generados en cada build desde la API real.
Lo que viaja en el paquete
| Fichero | Cómo se importa | Tamaño | Qué es |
|---|---|---|---|
| llms.txt | @amset/ui/llms.txt | 47 KB | El índice para un modelo de lenguaje: las reglas y una línea por componente con sus props. |
| llms-full.txt | @amset/ui/llms-full.txt | 659 KB | Lo mismo con cada prop, su tipo y su descripción. |
| AGENTS.md | @amset/ui/AGENTS.md | 47 KB | Las instrucciones para un asistente de código: reglas y resumen de cada componente. |
| api.json | @amset/ui/api.json | 681 KB | Las props reales de cada componente leídas del compilador, los iconos y las utilidades. |
| docs.json | @amset/ui/docs.json | 911 KB | El texto de cada ficha: qué es, cuándo usarlo y cuándo no, teclado y accesibilidad. |
| props.en.json | @amset/ui/props.en.json | 433 KB | La descripción en inglés de cada prop. |
| knobs.json | @amset/ui/knobs.json | 33 KB | Las variables CSS que se pueden tocar de cada componente. |
| examples.json | @amset/ui/examples.json | 140 KB | Un ejemplo de uso real por cada historia del banco de pruebas. |
| locales/en.json | @amset/ui/locales/en.json | 42 KB | Todas las claves de los textos de la biblioteca: la plantilla para traducirla a otro idioma. |
llms.txt y llms-full.txt los sirve también esta web en su raíz, tal como salen del paquete de la versión 0.17.1:
AGENTS.md y la skill
AGENTS.md empieza por las reglas que no se discuten —no inventar componentes ni props, importar del índice, no escribir colores a mano— y sigue con un resumen de cada componente. Basta con decirle al asistente dónde está:
Antes de escribir código con @amset/ui, lee node_modules/@amset/ui/dist/AGENTS.md.Si un componente o una prop no está en node_modules/@amset/ui/dist/api.json, no existe.El paquete trae además una skill para Claude Code, skills/amset-ui/SKILL.md, con las mismas reglas y cuándo usarla: cópiala a .claude/skills/ de tu proyecto.
El servidor MCP
@amset/mcp le da a tu asistente herramientas para buscar componentes, leer sus props reales, ver ejemplos, compilar un fragmento contra la biblioteca instalada y generar un tema.
Tokens en Figma
El repositorio de la biblioteca trae un plugin de Figma que mete los tokens como Variables: una colección de color con los modos claro y oscuro —cambiar de modo en un marco cambia el tema entero, como data-theme en el código— y otra con tipografía, espacio, radios, alturas de control, duraciones y curvas. Se vuelve a lanzar cuando cambian: actualiza los valores, no duplica.
npm run export:figma # en el repositorio de amset-ui: escribe dist/figma-tokens.json- Los colores salen en hexadecimal (Figma no entiende OKLCH) y las medidas en píxeles.
- Funciona en cualquier plan de Figma: escribir variables por la API de Figma exige el plan Enterprise, un plugin no.