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.
| URL | Contenido |
|---|---|
/llms.txt | El índice: un breve resumen de la librería y un enlace a cada archivo Markdown. |
/llms-full.txt | La guía global y la guía de cada componente en un solo archivo, para pegar en un chat. |
/docs/llms.md | La guía global: configuración, convenciones comunes, errores frecuentes y el índice de componentes. Es el cuerpo de la skill. |
/docs/components/<name>.md | La 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).
