Skill local

Un archivo de skill integrado que OpenCode y Claude Code descubren solos en cualquier espacio de trabajo que use componentes de Volt UI.

Qué es

La skill vive en .agents/skills/volt-ui/SKILL.md dentro del repositorio de Volt UI. Cualquier agente de IA compatible con skills al estilo de OpenCode la cargará automáticamente y usará las convenciones, los selectores y el catálogo de componentes al escribir código para tu proyecto.

Instalar la skill

La forma más rápida de instalar la skill en un proyecto es copiarla en la ubicación estándar de skills locales:

mkdir -p .agents/skills/volt-ui && curl -fsSL https://volt-ui.pages.dev/.agents/skills/volt-ui/SKILL.md -o .agents/skills/volt-ui/SKILL.md

Qué cubre la skill

  • Contexto del stack — Angular 21, signals sin zonas, OnPush, standalone, Tailwind v4, ng-primitives, CVA
  • Convenciones de nombresui-* frente a volt-* , selectores de elemento frente a selectores de atributo
  • Catálogo de componentes — componentes estables y beta con sus selectores y entradas principales
  • Reglas de superposición — disparadores como directiva de atributo + <ng-template> para dialog, drawer, popover, tooltip y dropdown-menu
  • Reactive Forms — qué componentes son CVA y cómo conectar FormControl
  • Sistema de temasprovideVoltTheme , colores, estilos y modo oscuro

Ejemplo de regla de la skill

// Overlays are template-based
<button [uiDialog]="dialogTpl">Open</button>
<ng-template #dialogTpl let-close="close">
  <div uiDialogOverlay></div>
  <div uiDialogContent>...</div>
</ng-template>

La skill le dice explícitamente al agente que nunca escriba <ui-dialog> , <ui-tooltip> ni otros selectores de elemento inválidos.