mintlify · locadex-agent · Jan 24, 2026
diff --git a/es/ai/skillmd.mdx b/es/ai/skillmd.mdx
@@ -62,4 +62,35 @@ Mintlify genera un archivo `skill.md` siguiendo la [especificación de agentskil
 
 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.
+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. Se admiten los siguientes campos:
+
+| 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`, `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`, `version`). |
+| `allowed-tools` | string | Lista delimitada por espacios de herramientas preaprobadas que la skill puede usar (experimental). |
+
+<div id="example-custom-skillmd">
+  ### Ejemplo de `skill.md` personalizado
+</div>
+
+```md
+---
+name: mintlify-docs
+description: Crea 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"
+---
+```
diff --git a/fr/ai/skillmd.mdx b/fr/ai/skillmd.mdx
@@ -62,4 +62,35 @@ Mintlify génère un fichier `skill.md` selon la [spécification agentskills.io]
 
 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`.
 
-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.
+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="frontmatter-fields">
+  ### Champs de frontmatter
+</div>
+
+Les fichiers `skill.md` personnalisés doivent commencer par un frontmatter YAML. Les champs suivants sont pris en charge :
+
+| Nom du champ    | Type   | Description                                                                                     |
+| --------------- | ------ | ----------------------------------------------------------------------------------------------- |
+| `name`          | string | Le nom de votre skill.                                                                         |
+| `description`   | string | Une brève description de ce que fait votre skill.                                              |
+| `license`       | string | La licence de votre skill (par exemple : `MIT`, `Apache-2.0`).                                 |
+| `compatibility` | string | Exigences ou notes de compatibilité (par exemple : dépendances d&#39;exécution).                   |
+| `metadata`      | object | Métadonnées supplémentaires sous forme de paires clé-valeur de chaînes de caractères (par ex. : `author`, `version`). |
+| `allowed-tools` | string | Liste, séparée par des espaces, des outils préautorisés que le skill peut utiliser (expérimental). |
+
+<div id="example-custom-skillmd">
+  ### Exemple de fichier `skill.md` personnalisé
+</div>
+
+```md
+---
+name: mintlify-docs
+description: Créez et maintenez des sites de documentation avec Mintlify. À utiliser pour créer des pages de documentation, configurer la navigation, ajouter des composants ou mettre en place des références API.
+license: MIT
+compatibility: Requires Node.js for CLI. Works with any Git-based workflow.
+metadata:
+  author: mintlify
+  version: "1.0"
+---
+```