mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
6289fd8220
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
93 lines
5.3 KiB
Plaintext
93 lines
5.3 KiB
Plaintext
---
|
|
title: "skill.md"
|
|
description: "Prepara tu documentación para trabajar con agentes mediante un archivo de capacidades estructurado."
|
|
keywords: ["agentes de IA","habilidades","habilidades de agente","agentes"]
|
|
---
|
|
|
|
import { PreviewButton } from "/snippets/previewbutton.jsx"
|
|
|
|
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](https://agentskills.io/specification) 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.
|
|
|
|
<PreviewButton href="https://mintlify.com/docs/skill.md">Abrir el skill.md de este sitio.</PreviewButton>
|
|
|
|
<Tip>
|
|
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.
|
|
</Tip>
|
|
|
|
<div id="use-skillmd-files-with-agents">
|
|
## Usa archivos `skill.md` con agentes
|
|
</div>
|
|
|
|
<Note>
|
|
Si utilizas un [proxy inverso](/es/deploy/reverse-proxy), configúralo para reenviar las rutas `/skill.md` y `/.well-known/skills/*` (con el almacenamiento en caché deshabilitado) a tu subdominio de Mintlify.
|
|
</Note>
|
|
|
|
Los agentes pueden procesar tu archivo `skill.md` con la [CLI de skills](https://www.npmjs.com/package/skills).
|
|
|
|
```bash
|
|
npx skills add your-docs-domain.com
|
|
```
|
|
|
|
Esto añade las capacidades de tu producto al contexto del agente para que pueda realizar acciones en nombre de los usuarios.
|
|
|
|
<Tip>
|
|
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.
|
|
</Tip>
|
|
|
|
<div id="skillmd-structure">
|
|
## Estructura de `skill.md`
|
|
</div>
|
|
|
|
Mintlify genera un archivo `skill.md` siguiendo la [especificación de agentskills.io](https://agentskills.io/specification). 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.
|
|
|
|
<div id="custom-skillmd-files">
|
|
## Archivos `skill.md` personalizados
|
|
</div>
|
|
|
|
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](https://agentskills.io/specification) para garantizar la compatibilidad con las herramientas para agentes.
|
|
|
|
<div id="frontmatter-fields">
|
|
### Campos de frontmatter
|
|
</div>
|
|
|
|
Los archivos `skill.md` personalizados deben comenzar con frontmatter YAML.
|
|
|
|
| Campo | Tipo | Descripción |
|
|
| --------------- | ------ | -------------------------------------------------------------------------------------------------------- |
|
|
| `name` | string | El nombre de tu skill. |
|
|
| `description` | string | Una breve descripción de lo que hace tu skill. |
|
|
| `license` | string | La licencia de tu skill (por ejemplo, `MIT` o `Apache-2.0`). |
|
|
| `compatibility` | string | Requisitos o notas de compatibilidad (por ejemplo, dependencias de tiempo de ejecución). |
|
|
| `metadata` | object | metadata adicional representada como pares key-value de tipo string (por ejemplo, `author` o `version`). |
|
|
| `allowed-tools` | string | Lista delimitada por espacios de herramientas preaprobadas que la skill puede usar (experimental). |
|
|
|
|
```md Example frontmatter
|
|
---
|
|
name: mintlify
|
|
description: Construye y mantén sitios de documentación con Mintlify. Úsalo al crear páginas de documentación, configurar la navegación, agregar componentes o configurar referencias de API.
|
|
license: MIT
|
|
compatibility: Requiere Node.js para CLI. Funciona con cualquier flujo de trabajo basado en Git.
|
|
metadata:
|
|
author: mintlify
|
|
version: "1.0"
|
|
---
|
|
```
|