Skip to main content
Mintlify aloja un archivo skill.md en la raíz de tu proyecto que describe lo que los agentes de IA pueden hacer con tu producto. La especificación de skill.md es un formato estructurado y legible por máquinas que hace explícitas las capacidades, los datos de entrada obligatorios y las restricciones de los productos para que los agentes puedan utilizarlos de forma más confiable. Mintlify genera automáticamente un archivo skill.md para tu proyecto analizando tu documentación con un bucle de agentes. Este archivo se mantiene actualizado a medida que realizas cambios en tu documentación y no requiere mantenimiento. Opcionalmente, puedes añadir un archivo skill.md personalizado en la raíz de tu proyecto que reemplace al generado automáticamente. Consulta tu skill.md añadiendo /skill.md a la URL de tu sitio de documentación. Mintlify solo genera archivos skill.md para sitios de documentación que sean públicos. Abrir el skill.md de este sitio.
Tanto los archivos llms.txt como skill.md ayudan a los agentes a trabajar con tu documentación, pero cumplen funciones diferentes.
  • llms.txt es un directorio. Enumera todas las páginas de tu documentación con descripciones para que los agentes sepan dónde encontrar la información.
  • skill.md es un resumen de capacidades. Indica a los agentes qué pueden lograr con tu producto, qué datos de entrada necesitan y qué restricciones se aplican.

​
Usa archivos skill.md con agentes

Si utilizas un proxy inverso, configúralo para reenviar las rutas /skill.md y /.well-known/skills/* (con el almacenamiento en caché deshabilitado) a tu subdominio de Mintlify.
Los agentes pueden procesar tu archivo skill.md con la CLI de skills. 
npx skills add yourdomain.com/docs/skill.md
Esto añade las capacidades de tu producto al contexto del agente para que pueda realizar acciones en nombre de los usuarios.
Enseña a tus usuarios cómo usar archivos skill.md con agentes para que obtengan mejores resultados al utilizar tu producto con sus herramientas de IA.

​
Estructura de skill.md

Mintlify genera un archivo skill.md siguiendo la especificación de agentskills.io. El archivo generado incluye:
  • Metadatos: Nombre del proyecto, descripción y versión.
  • Capacidades: Lo que los agentes pueden hacer con tu producto.
  • Habilidades: Acciones específicas organizadas por categoría.
  • Flujos de trabajo: Procedimientos paso a paso para tareas comunes.
  • Integración: Herramientas y servicios compatibles.
  • Contexto: Información contextual sobre la arquitectura de tu producto.

​
Archivos skill.md personalizados

Añade un archivo skill.md a la raíz de tu proyecto para reemplazar el archivo generado automáticamente. Si eliminas un archivo personalizado, Mintlify genera un nuevo archivo skill.md. Escribe un archivo personalizado cuando quieras tener un control preciso sobre cómo los agentes interactúan con tu producto. Sigue la especificación de agentskills.io para garantizar la compatibilidad con las herramientas para agentes.