enes

IA y LLMs

FluentUI Svelte publica documentación escrita para agentes de programación con IA: una skill con las reglas y los errores comunes de la librería, y una versión en Markdown de cada página. Con ellas, un agente escribe código contra la API real en lugar de adivinarla a partir de otras librerías de Fluent UI.

Skill para agentes

Instala la skill y tu agente (Claude Code, Codex, Cursor, GitHub Copilot y muchos más) cargará la configuración, las convenciones que comparten todos los componentes, los errores comunes y el índice de componentes cada vez que trabaje con la librería.

npx skills add JLAcostaEC/fluentui-svelte --skill fluentui-svelte

La skill lee la guía de cada componente desde node_modules, así que la guía siempre coincide con la versión que instalaste.

Mantén la skill sincronizada con el paquete

La skill también viene dentro del paquete de npm. El comando experimental_sync de la CLI de skills la enlaza en tu proyecto, así que se actualiza cada vez que actualizas fluentui-svelte.

npx skills experimental_sync

Para sincronizarla después de cada instalación, añádela al script prepare de tu package.json:

{
  "scripts": {
    "prepare": "svelte-kit sync && skills experimental_sync -y"
  }
}

Sync es una función en vista previa de la CLI de skills: su nombre y sus opciones pueden cambiar.

Archivos Markdown

El sitio también publica su documentación en Markdown plano, siguiendo la propuesta llms.txt, para que un agente pueda leerla sin procesar HTML.

URLContenido
/llms.txtEl índice: un breve resumen de la librería y un enlace a cada archivo Markdown.
/llms-full.txtLa guía global y la guía de cada componente en un solo archivo, para pegar en un chat.
/docs/llms.mdLa guía global: configuración, convenciones comunes, errores frecuentes y el índice de componentes. Es el cuerpo de la skill.
/docs/components/<name>.mdLa guía de un componente, con su uso, ejemplos y props. Es la URL de su página más .md.

Cada página de componente tiene además un botón Copiar como Markdown, para pegar su guía en un chat, y un enlace Ver como Markdown.

Dentro del paquete

El paquete de npm incluye los mismos archivos, así que siempre coinciden con la versión que instalaste:

node_modules/fluentui-svelte/skills/fluentui-svelte/SKILL.md
node_modules/fluentui-svelte/dist/components/<name>/docs/llms.md

Sin la skill

Los agentes que no admiten skills también pueden encontrar la documentación. Añade esto a tu AGENTS.md, CLAUDE.md o .github/copilot-instructions.md:

This project uses fluentui-svelte for its UI. Before writing UI code, read
node_modules/fluentui-svelte/skills/fluentui-svelte/SKILL.md, then the
docs/llms.md of every component you use (that file lists where they are).
Editar este documento Ver como Markdown