Cómo validar un archivo llms.txt antes de publicarlo

Un llms.txt roto es peor que ningún llms.txt. Si el archivo tiene un formato incorrecto, las herramientas y modelos que lo leen obtienen una imagen confusa o incompleta de su sitio, lo contrario de lo que usted deseaba. La buena noticia: el formato llms.txt es simple, por lo que la validación es rápida una vez que sabes qué verificar.

Esta es una lista de verificación práctica y sencilla que puede ejecutar antes de cada publicación.

Lo que realmente requiere el formato

El formato llms.txt (de llmstxt.org) es un Markdown intencionalmente mínimo:

• Un único título H1 que nombre el proyecto: la primera línea del archivo.
• Una cita resumida en bloque opcional pero recomendada (> …) justo después del título.
• Cero o más secciones H2 (## Docs, ## API,…), cada una de las cuales contiene una lista de enlaces.
• Cada enlace es un elemento de la lista: - [Name](https://example.com/page): short description.

Esa es toda la estructura. La mayoría de los problemas de validación son desviaciones de esta forma.

La lista de verificación previa a la publicación

1. Exactamente un H1, y es el primero

El archivo debería abrirse con una línea # Title. Errores comunes:

• No hay H1 en absoluto (el archivo comienza con prosa o una lista).
• Múltiples H1 (use ## para las secciones en su lugar).
• El H1 enterrado debajo de otro contenido.

2. Una cita en bloque resumida

Inmediatamente después del título, incluya una cita en bloque > de una línea que describa cuál es el sitio o proyecto. Le brinda a cualquier lector, modelo o humano, un contexto instantáneo. Es opcional en la especificación, pero se recomienda en la práctica.

3. Secciones que agrupan tus enlaces

Utilice los encabezados ## para agrupar enlaces relacionados: ## Documentation, ## API Reference, ## Guides. Es difícil navegar por un montón de enlaces sin secciones. Si tiene más de un puñado de enlaces, agrúpelos.

4. Enlaces bien formados

Verifique cada enlace para:

• URL vacías: [Docs]() sin nada entre paréntesis.
• Falta texto del enlace, [](https://…) sin etiqueta.
• URL con formato incorrecto: errores tipográficos, falta https://, caracteres extraviados.
• Enlaces duplicados: la misma URL que aparece más de una vez desperdicia espacio y indica un error de copiar y pegar.

5. Descripciones en cada enlace

Un - [Quickstart](https://…) simple es mucho menos útil que - [Quickstart](https://…): Get set up in five minutes. La descripción le dice a un modelo por qué el enlace es importante y cuándo seguirlo. Agregue uno a cada enlace de elemento de lista.

6. Sea conciso

llms.txt es un índice, no un archivo. Si su archivo es muy grande (decenas de kilobytes o más), es una señal de que está llenando contenido completo donde pertenece una lista de enlaces seleccionados.

7. Considere un complemento llms-full.txt

Si realmente tiene muchos modelos de contenido de formato largo que desee en su totalidad, publique un llms-full.txt por separado con el texto completo y mantenga llms.txt como el mapa liviano que lo vincula.

Un ejemplo rápido de un archivo limpio

MANTENERX23MANTENERMANTENERX24MANTENERMANTENERX25MANTENER

Un H1, un resumen, secciones agrupadas, enlaces descritos, sin duplicados. Ese es el objetivo.## Validarlo automáticamente

Ejecutar la lista de verificación a mano funciona, pero es fácil pasar por alto una URL duplicada o una descripción faltante en un archivo largo. Nuestro validador llms.txt gratuito verifica todo lo anterior de una sola vez y le brinda una puntuación de estructura además de sugerencias específicas que tienen en cuenta las líneas.

Puedes validar de dos maneras:

• Pegue su contenido directamente en el validador, o
• Ingrese una URL: apunte a su sitio (obtendremos /llms.txt automáticamente) o enlace directamente al archivo. Esto es útil para comprobar un archivo que ya está activo.

De cualquier manera, verás exactamente qué corregir antes o después de publicar.

Después de solucionar los problemas

Una vez que el validador esté satisfecho:

1. Guarde el archivo como llms.txt y cárguelo en la raíz de su dominio (https://example.com/llms.txt).
2. Vuelva a ejecutar el validador con la URL activa para confirmar que se muestra como texto sin formato y es accesible.
3. Vuelva a verificarlo cada vez que reestructure su sitio o agregue secciones importantes.

El resultado final

La validación tarda un par de minutos y le evita enviar un archivo que engaña silenciosamente a las herramientas que lo leen. Ejecute la lista de verificación, corrija la estructura y confirme con el validador antes de publicar.

¿Aún no tienes un archivo? Genere un borrador limpio desde su sitio con el generador llms.txt, luego valídelo. Y si aún no está decidiendo si necesita uno, consulte Cuando llms.txt tiene sentido.