Skip to content

Translate custom skill files docs into es, fr, zh #5231

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mintlify merged 1 commit into from
Apr 9, 2026
+169 −96
Merged

Translate custom skill files docs into es, fr, zh #5231

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 55 additions & 31 deletions es/ai/skillmd.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "skill.md"
description: "Genera archivos skill.md automáticamente para describir las capacidades de tu producto a los agentes de IA."
keywords: ["agentes de IA","habilidades","habilidades de agente","agentes"]
keywords: ["agentes de IA", "habilidades", "habilidades de agente", "agentes"]
---

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.
Expand All @@ -10,27 +10,29 @@ La [especificación de skill.md](https://agentskills.io/specification) es un for

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.

<Note>
Generar o actualizar un archivo `skill.md` puede tardar hasta 24 horas.
</Note>
<Note>Generar o actualizar un archivo `skill.md` puede tardar hasta 24 horas.</Note>

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>
<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.
- `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`, `/.well-known/skills/*` y `/.well-known/agent-skills/*` a tu subdominio de Mintlify.
Si utilizas un [proxy inverso](/es/deploy/reverse-proxy), configúralo para
reenviar las rutas `/skill.md`, `/.well-known/skills/*` y
`/.well-known/agent-skills/*` 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).
Expand All @@ -42,7 +44,8 @@ npx skills add https://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.
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">
Expand All @@ -51,20 +54,45 @@ Esto añade las capacidades de tu producto al contexto del agente para que pueda

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.
- **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 id="custom-skill-files">
## Archivos de skill 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`.
Añade archivos de skill personalizados para reemplazar el `skill.md` generado automáticamente. Mintlify admite alojar un único archivo de skill y un directorio para múltiples skills. Si eliminas todos los archivos de skill personalizados, 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="single-skill-file">
### Archivo de skill único
</div>

Añade un archivo `skill.md` a la raíz de tu proyecto para reemplazar el archivo generado automáticamente.

<div id="multiple-skill-files">
### Múltiples archivos de skill
</div>

Añade múltiples archivos de skill al directorio `.mintlify/skills/` de tu proyecto. Cada skill debe estar en su propio subdirectorio con un archivo `SKILL.md`:

```
.mintlify/
skills/
payments/
SKILL.md
analytics/
SKILL.md
```

Cuando tienes múltiples skills, el endpoint `/skill.md` redirige al endpoint de descubrimiento `/.well-known/skills/index.json`, que lista todas las skills disponibles. Los endpoints de descubrimiento hacen que cada skill sea accesible individualmente.

<Note>
Puedes usar ambos enfoques juntos con un archivo `skill.md` en la raíz y un directorio `.mintlify/skills/`. El índice de descubrimiento incluye todas las skills.
</Note>

<div id="frontmatter-fields">
### Campos de frontmatter
Expand Down Expand Up @@ -99,10 +127,6 @@ metadata:

Mintlify aloja directorios de skills en `/.well-known/skills/` y `/.well-known/agent-skills/` que los agentes pueden usar para descubrir y obtener tus archivos de skills de forma programática.

<Note>
Si utilizas un [proxy inverso](/es/deploy/reverse-proxy), configúralo para reenviar las rutas `/.well-known/skills/*` y `/.well-known/agent-skills/*` a tu subdominio de Mintlify.
</Note>

<div id="agent-skills-discovery">
### Descubrimiento agent-skills (recomendado)
</div>
Expand All @@ -126,14 +150,14 @@ El endpoint `/.well-known/agent-skills/` sigue la [especificación agent-skills
}
```

| Campo | Descripción |
| ----- | ----------- |
| `$schema` | URL del esquema para la especificación agent-skills discovery 0.2.0. |
| `name` | Un slug seguro para URL derivado del campo `name` en el frontmatter de tu `skill.md`. |
| `type` | El formato de la skill. Siempre `skill-md`. |
| `description` | Una breve descripción del frontmatter de tu `skill.md`. |
| `url` | La ruta para obtener el archivo de skill completo. |
| `digest` | Un hash `sha256` del contenido del archivo de skill para verificación de integridad. |
| Campo | Descripción |
| ------------- | -------------------------------------------------------------------------------------- |
| `$schema` | URL del esquema para la especificación agent-skills discovery 0.2.0. |
| `name` | Un slug seguro para URL derivado del campo `name` en el frontmatter de tu `skill.md`. |
| `type` | El formato de la skill. Siempre `skill-md`. |
| `description` | Una breve descripción del frontmatter de tu `skill.md`, truncada a 1024 caracteres. |
| `url` | La ruta para obtener el archivo de skill completo. |
| `digest` | Un hash `sha256` del contenido del archivo de skill para verificación de integridad. |

`GET /.well-known/agent-skills/{name}/SKILL.md` devuelve el archivo `skill.md` de una skill específica identificada por su nombre slugificado del índice.

Expand Down
85 changes: 55 additions & 30 deletions fr/ai/skillmd.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,27 +10,29 @@ La [spécification skill.md](https://agentskills.io/specification) est un format

Mintlify génère automatiquement un fichier `skill.md` pour votre projet en analysant votre documentation avec une boucle pilotée par des agents. Ce fichier reste à jour à mesure que vous mettez à jour votre documentation et ne nécessite aucune maintenance. Vous pouvez également ajouter un fichier `skill.md` personnalisé à la racine de votre projet qui remplace celui généré automatiquement.

<Note>
La génération ou la mise à jour d'un fichier `skill.md` peut prendre jusqu'à 24 heures.
</Note>
<Note>La génération ou la mise à jour d'un fichier `skill.md` peut prendre jusqu'à 24 heures.</Note>

Affichez votre `skill.md` en ajoutant `/skill.md` à l'URL de votre site de documentation. Mintlify ne génère des fichiers `skill.md` que pour les sites de documentation publics.

<PreviewButton href="https://mintlify.com/docs/skill.md">Ouvrir le skill.md de ce site.</PreviewButton>
<PreviewButton href="https://mintlify.com/docs/skill.md">
Ouvrir le skill.md de ce site.
</PreviewButton>

<Tip>
Les fichiers `llms.txt` et `skill.md` aident tous deux les agents à travailler avec votre documentation, mais ils ont des objectifs différents.

* `llms.txt` est un index. Il répertorie toutes les pages de votre documentation avec des descriptions pour que les agents sachent où trouver l'information.
* `skill.md` est un résumé de capacités. Il indique aux agents ce qu'ils peuvent accomplir avec votre produit, quelles entrées sont nécessaires et quelles contraintes s'appliquent.
- `llms.txt` est un index. Il répertorie toutes les pages de votre documentation avec des descriptions pour que les agents sachent où trouver l'information.
- `skill.md` est un résumé de capacités. Il indique aux agents ce qu'ils peuvent accomplir avec votre produit, quelles entrées sont nécessaires et quelles contraintes s'appliquent.
</Tip>

<div id="use-skillmd-files-with-agents">
## Utiliser les fichiers `skill.md` avec des agents
</div>

<Note>
Si vous utilisez un [proxy inverse](/fr/deploy/reverse-proxy), configurez-le pour qu'il redirige les chemins `/skill.md`, `/.well-known/skills/*` et `/.well-known/agent-skills/*` vers votre sous-domaine Mintlify.
Si vous utilisez un [proxy inverse](/fr/deploy/reverse-proxy), configurez-le
pour qu'il redirige les chemins `/skill.md`, `/.well-known/skills/*` et
`/.well-known/agent-skills/*` vers votre sous-domaine Mintlify.
</Note>

Les agents peuvent traiter votre fichier `skill.md` avec la [CLI skills](https://www.npmjs.com/package/skills).
Expand All @@ -42,7 +44,9 @@ npx skills add https://your-docs-domain.com
Cela ajoute les capacités de votre produit au contexte de l'agent afin qu'il puisse effectuer des actions au nom des utilisateurs.

<Tip>
Expliquez à vos utilisateurs comment utiliser les fichiers `skill.md` avec des agents afin qu'ils obtiennent de meilleurs résultats en utilisant votre produit avec leurs outils d'IA.
Expliquez à vos utilisateurs comment utiliser les fichiers `skill.md` avec des
agents afin qu'ils obtiennent de meilleurs résultats en utilisant votre produit
avec leurs outils d'IA.
</Tip>

<div id="skillmd-structure">
Expand All @@ -51,20 +55,45 @@ Cela ajoute les capacités de votre produit au contexte de l'agent afin qu'il pu

Mintlify génère un fichier `skill.md` selon la [spécification agentskills.io](https://agentskills.io/specification). Le fichier généré comprend :

* **Metadata** : nom du projet, description et version.
* **Capacités** : ce que les agents peuvent accomplir avec votre produit.
* **Compétences** : actions spécifiques organisées par catégorie.
* **Flux de travail** : procédures étape par étape pour les tâches courantes.
* **Intégrations** : outils et services pris en charge.
* **Contexte** : informations générales sur l'architecture de votre produit.
- **Metadata** : nom du projet, description et version.
- **Capacités** : ce que les agents peuvent accomplir avec votre produit.
- **Compétences** : actions spécifiques organisées par catégorie.
- **Flux de travail** : procédures étape par étape pour les tâches courantes.
- **Intégrations** : outils et services pris en charge.
- **Contexte** : informations générales sur l'architecture de votre produit.

<div id="custom-skillmd-files">
## Fichiers `skill.md` personnalisés
<div id="custom-skill-files">
## Fichiers de skill personnalisés
</div>

Ajoutez un fichier `skill.md` à la racine de votre projet pour remplacer le fichier généré automatiquement. Si vous supprimez un fichier personnalisé, Mintlify génère un nouveau fichier `skill.md`.
Ajoutez des fichiers de skill personnalisés pour remplacer le `skill.md` généré automatiquement. Mintlify prend en charge l'hébergement d'un fichier de skill unique et d'un répertoire pour plusieurs skills. Si vous supprimez tous les fichiers de skill personnalisés, Mintlify génère un nouveau fichier `skill.md`.

Rédigez un fichier personnalisé si vous souhaitez un contrôle précis sur la manière dont les agents interagissent avec votre produit. Suivez la [spécification agentskills.io](https://agentskills.io/specification) pour garantir la compatibilité avec les outils des agents.
<div id="single-skill-file">
### Fichier de skill unique
</div>

Ajoutez un fichier `skill.md` à la racine de votre projet pour remplacer le fichier généré automatiquement.

<div id="multiple-skill-files">
### Fichiers de skill multiples
</div>

Ajoutez plusieurs fichiers de skill au répertoire `.mintlify/skills/` de votre projet. Chaque skill doit se trouver dans son propre sous-répertoire avec un fichier `SKILL.md` :

```
.mintlify/
skills/
payments/
SKILL.md
analytics/
SKILL.md
```

Lorsque vous disposez de plusieurs skills, l'endpoint `/skill.md` redirige vers l'endpoint de découverte `/.well-known/skills/index.json`, qui liste toutes les skills disponibles. Les endpoints de découverte rendent chaque skill accessible individuellement.

<Note>
Vous pouvez combiner les deux approches avec un fichier `skill.md` à la racine et un répertoire `.mintlify/skills/`. L'index de découverte inclut toutes les skills.
</Note>

<div id="frontmatter-fields">
### Champs de frontmatter
Expand Down Expand Up @@ -99,10 +128,6 @@ metadata:

Mintlify héberge des répertoires de skills à `/.well-known/skills/` et `/.well-known/agent-skills/` que les agents peuvent utiliser pour découvrir et récupérer vos fichiers de skills de manière programmatique.

<Note>
Si vous utilisez un [proxy inverse](/fr/deploy/reverse-proxy), configurez-le pour qu'il redirige les chemins `/.well-known/skills/*` et `/.well-known/agent-skills/*` vers votre sous-domaine Mintlify.
</Note>

<div id="agent-skills-discovery">
### Découverte agent-skills (recommandé)
</div>
Expand All @@ -126,14 +151,14 @@ L'endpoint `/.well-known/agent-skills/` suit la [spécification agent-skills dis
}
```

| Champ | Description |
| ----- | ----------- |
| `$schema` | URL du schéma pour la spécification agent-skills discovery 0.2.0. |
| `name` | Un slug compatible URL dérivé du champ `name` dans le frontmatter de votre `skill.md`. |
| `type` | Le format de la skill. Toujours `skill-md`. |
| `description` | Une brève description issue du frontmatter de votre `skill.md`. |
| `url` | Le chemin pour récupérer le fichier de skill complet. |
| `digest` | Un hash `sha256` du contenu du fichier de skill pour la vérification d'intégrité. |
| Champ | Description |
| ------------- | ------------------------------------------------------------------------------------------------- |
| `$schema` | URL du schéma pour la spécification agent-skills discovery 0.2.0. |
| `name` | Un slug compatible URL dérivé du champ `name` dans le frontmatter de votre `skill.md`. |
| `type` | Le format de la skill. Toujours `skill-md`. |
| `description` | Une brève description issue du frontmatter de votre `skill.md`, tronquée à 1024 caractères. |
| `url` | Le chemin pour récupérer le fichier de skill complet. |
| `digest` | Un hash `sha256` du contenu du fichier de skill pour la vérification d'intégrité. |

`GET /.well-known/agent-skills/{name}/SKILL.md` renvoie le fichier `skill.md` d'une skill spécifique identifiée par son nom slugifié depuis l'index.

Expand Down
Loading
Loading