<!-- COPIADO de catalog/instructions.md por scripts/gen-skill-refs.mjs. NÃO edite aqui. -->

Catálogo da design system ui-nova (vueui-nova-kit). Use SOMENTE os componentes deste catálogo; o renderer rejeita qualquer outro nome.

## Diretrizes

0. Ids: cada componente tem um `id` único na surface, que deve ser um identificador UAX #31: letras, dígitos e `_`, sem hífen (ex.: `linha_contato`, `kpi_receita`). Um componente se chama `root`.
1. Layout: organize com `Column` (vertical) e `Row` (horizontal). `gap` usa a escala de espaçamento da ui-nova ("0".."24"). Para seções com título use `Section`; para blocos destacados use `Card`; para grades de cards use `CardGrid`.
2. Reuso: antes de montar algo com primitivos, verifique se existe um componente pronto (ex.: métricas → `StatCard`; pares rótulo/valor → `DescriptionList`; listas tabulares → `Table`; estado vazio → `EmptyState`; status de agente → `AgentChip`/`ThoughtLine`).
3. Texto: use `Text` com `variant` (h1..h5, body, caption...). Markdown apenas no subconjunto seguro (sem HTML, sem imagens). Nunca envie HTML.
4. Inputs: ligue o valor ao data model com `{"@path": "/form/campo"}` (`value`, `expanded` ou `open`, conforme o componente). A escrita é local; o agente só recebe os valores quando uma action dispara — inclua no `context` da action os paths que você precisa.
5. Botões: `Button` exige `child` (normalmente um `Text`) e `action`. Use `variant` "primary" só para a ação principal da tela.
6. Validação: use `@checks` com as funções `required`, `regex`, `length`, `numeric`, `email`; a mensagem vai em `message` do check (não crie um Text separado para o erro). Um Button cujo `@checks` falha fica desabilitado.
7. Formatação: concatene com `formatString("Olá ${/user/name}")`; números/moeda/datas com `formatNumber`, `formatCurrency`, `formatDate`.
8. Ícones: toda prop de ícone (`icon`, `leadingIcon`...) aceita apenas valores de `IconName`. Nunca SVG, URL ou emoji. Para um ícone solto use `{"component": "Icon", "icon": "..."}`.
9. Acessibilidade: todo input precisa de `label`; botões só com ícone precisam de `@accessibility.label`; `Image` precisa de `alt` (ou `decorative: true`).
10. Tema: não envie cores, fontes ou CSS. O visual vem dos tokens do host (claro/escuro). Use `variant`/`tone` semânticos (success, warning, danger...); props de cor (`dotColor`, `items[].color`, `stats[].color`) aceitam só os tokens primary, info, success, warning, danger e neutral.
11. Hierarquia estrita: `AccordionItem` só dentro de `Accordion`. Respeite exatamente a hierarquia pedida.
