@@ -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.
-
- ## Archivos `skill.md` personalizados
+
+ ## Archivos de skill 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`.
+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.
+
+ ### Archivo de skill único
+
+
+Añade un archivo `skill.md` a la raíz de tu proyecto para reemplazar el archivo generado automáticamente.
+
+
+ ### Múltiples archivos de skill
+
+
+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.
+
+
+ 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.
+
### Campos de frontmatter
@@ -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.
-
- 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.
-
-
### Descubrimiento agent-skills (recomendado)
@@ -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.
diff --git a/fr/ai/skillmd.mdx b/fr/ai/skillmd.mdx
index 5834da836..5cfabd691 100644
--- a/fr/ai/skillmd.mdx
+++ b/fr/ai/skillmd.mdx
@@ -10,19 +10,19 @@ 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.
-
- La génération ou la mise à jour d'un fichier `skill.md` peut prendre jusqu'à 24 heures.
-
+
La génération ou la mise à jour d'un fichier `skill.md` peut prendre jusqu'à 24 heures.
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.
-
Ouvrir le skill.md de ce site.
+
+ Ouvrir le skill.md de ce site.
+
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.
@@ -30,7 +30,9 @@ Affichez votre `skill.md` en ajoutant `/skill.md` à l'URL de votre site de docu
- 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.
Les agents peuvent traiter votre fichier `skill.md` avec la [CLI skills](https://www.npmjs.com/package/skills).
@@ -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.
- 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.
@@ -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.
-
- ## Fichiers `skill.md` personnalisés
+
+ ## Fichiers de skill personnalisés
-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.
+
+ ### Fichier de skill unique
+
+
+Ajoutez un fichier `skill.md` à la racine de votre projet pour remplacer le fichier généré automatiquement.
+
+
+ ### Fichiers de skill multiples
+
+
+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.
+
+
+ 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.
+
### Champs de frontmatter
@@ -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.
-
- 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.
-
-
### Découverte agent-skills (recommandé)
@@ -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.
diff --git a/zh/ai/skillmd.mdx b/zh/ai/skillmd.mdx
index 278314e20..437a1c344 100644
--- a/zh/ai/skillmd.mdx
+++ b/zh/ai/skillmd.mdx
@@ -10,19 +10,19 @@ Mintlify 会在你项目的根目录托管一个 `skill.md` 文件，用于描
Mintlify 会通过一个 agentic loop 分析你的文档，自动为你的项目生成一个 `skill.md` 文件。随着你更新文档，这个文件会自动保持最新且无需维护。你也可以选择在项目根目录添加一个自定义的 `skill.md` 文件，以覆盖自动生成的版本。
-
- 生成或更新 `skill.md` 文件最多可能需要 24 小时。
-
+
生成或更新 `skill.md` 文件最多可能需要 24 小时。
在你的文档站点 URL 末尾追加 `/skill.md`，即可查看你的 `skill.md`。Mintlify 只会为公开的文档站点生成 `skill.md` 文件。
-
打开本站点的 skill.md。
+
+ 打开本站点的 skill.md。
+
`llms.txt` 和 `skill.md` 都帮助 agent 使用你的文档，但它们的作用不同。
- * `llms.txt` 是一个目录。它列出你所有的文档页面及其说明，让 agent 知道去哪里查找信息。
- * `skill.md` 是一个能力概览。它告诉 agent 使用你的产品可以完成什么、需要哪些输入，以及有哪些约束条件。
+ - `llms.txt` 是一个目录。它列出你所有的文档页面及其说明，让 agent 知道去哪里查找信息。
+ - `skill.md` 是一个能力概览。它告诉 agent 使用你的产品可以完成什么、需要哪些输入，以及有哪些约束条件。
@@ -30,10 +30,12 @@ Mintlify 会通过一个 agentic loop 分析你的文档，自动为你的项目
- 如果你使用 [反向代理](/zh/deploy/reverse-proxy)，请将其配置为将对 `/skill.md`、`/.well-known/skills/*` 和 `/.well-known/agent-skills/*` 路径的请求转发到你的 Mintlify 子域。
+ 如果你使用[反向代理](/zh/deploy/reverse-proxy)，请将其配置为将对
+ `/skill.md`、`/.well-known/skills/*` 和 `/.well-known/agent-skills/*`
+ 路径的请求转发到你的 Mintlify 子域。
-代理可以使用 [skills 命令行界面 (CLI) ](https://www.npmjs.com/package/skills) 来处理你的 `skill.md`。
+代理可以使用 [skills 命令行界面 (CLI)](https://www.npmjs.com/package/skills) 来处理你的 `skill.md`。
```bash
npx skills add https://your-docs-domain.com
@@ -42,7 +44,8 @@ npx skills add https://your-docs-domain.com
这会将你的产品功能添加到代理的 context 中，使其能够代表用户执行操作。
- 向你的用户讲解如何将 `skill.md` 文件与代理配合使用，以便他们在结合你的产品使用 AI 工具时获得更好的效果。
+ 向你的用户讲解如何将 `skill.md` 文件与代理配合使用，以便他们在结合你的产品使用
+ AI 工具时获得更好的效果。
@@ -51,20 +54,45 @@ npx skills add https://your-docs-domain.com
Mintlify 会根据 [agentskills.io 规范](https://agentskills.io/specification) 生成一个 `skill.md` 文件。生成的文件包括：
-* **Metadata**：项目名称、说明和版本。
-* **Capabilities**：智能体可以通过你的产品完成的能力范围。
-* **Skills**：按类别组织的具体操作。
-* **Workflows**：常见任务的分步流程。
-* **Integration**：支持的工具和服务。
-* **Context**：与你产品架构相关的背景信息。
+- **Metadata**：项目名称、说明和版本。
+- **Capabilities**：智能体可以通过你的产品完成的能力范围。
+- **Skills**：按类别组织的具体操作。
+- **Workflows**：常见任务的分步流程。
+- **Integration**：支持的工具和服务。
+- **Context**：与你产品架构相关的背景信息。
+
+
+ ## 自定义 skill 文件
+
+
+添加自定义 skill 文件以覆盖自动生成的 `skill.md`。Mintlify 支持托管单个 skill 文件和用于多个 skill 的目录。如果你删除所有自定义 skill 文件，Mintlify 会重新生成一个 `skill.md` 文件。
+
+
+ ### 单个 skill 文件
+
+
+在项目根目录添加一个 `skill.md` 文件，以覆盖自动生成的文件。
-
- ## 自定义 `skill.md` 文件
+
+ ### 多个 skill 文件
-在项目根目录添加一个 `skill.md` 文件，以覆盖自动生成的文件。若删除自定义文件，Mintlify 会重新生成一个 `skill.md` 文件。
+将多个 skill 文件添加到项目中的 `.mintlify/skills/` 目录。每个 skill 必须位于自己的子目录中，并包含一个 `SKILL.md` 文件：
-当你希望对智能体如何与产品交互进行精细控制时，可以编写自定义文件。请遵循 [agentskills.io 规范](https://agentskills.io/specification) 以确保与智能体工具的兼容性。
+```
+.mintlify/
+ skills/
+ payments/
+ SKILL.md
+ analytics/
+ SKILL.md
+```
+
+当你有多个 skill 时，`/skill.md` 端点会重定向到 `/.well-known/skills/index.json` 发现端点，该端点列出所有可用的 skill。发现端点使每个 skill 可以被单独访问。
+
+
+ 你可以同时使用两种方式——在根目录放置一个 `skill.md` 文件，并使用 `.mintlify/skills/` 目录。发现索引会包含所有 skill。
+
### Frontmatter 字段
@@ -76,10 +104,10 @@ Mintlify 会根据 [agentskills.io 规范](https://agentskills.io/specification)
| --------------- | ------ | --------------------------------------------------------- |
| `name` | string | 该技能的名称。 |
| `description` | string | 该技能功能的简要说明。 |
-| `license` | string | 该技能的许可证 (例如，`MIT`、`Apache-2.0`) 。 |
-| `compatibility` | string | 运行要求或兼容性说明 (例如，运行时依赖) 。 |
-| `metadata` | object | 以字符串形式的 key-value 对提供的附加 metadata (例如，`author`、`version`) 。 |
-| `allowed-tools` | string | 以空格分隔的、预先批准可供该技能使用的工具列表 (实验性) 。 |
+| `license` | string | 该技能的许可证（例如，`MIT`、`Apache-2.0`）。 |
+| `compatibility` | string | 运行要求或兼容性说明（例如，运行时依赖）。 |
+| `metadata` | object | 以字符串形式的 key-value 对提供的附加 metadata（例如，`author`、`version`）。 |
+| `allowed-tools` | string | 以空格分隔的、预先批准可供该技能使用的工具列表（实验性）。 |
```md Example frontmatter
---
@@ -99,10 +127,6 @@ metadata:
Mintlify 在 `/.well-known/skills/` 和 `/.well-known/agent-skills/` 托管了 skills 目录，代理可以通过这些目录以编程方式发现和获取你的 skill 文件。
-
- 如果你使用 [反向代理](/zh/deploy/reverse-proxy)，请将其配置为将 `/.well-known/skills/*` 和 `/.well-known/agent-skills/*` 路径的请求转发到你的 Mintlify 子域。
-
-
### Agent-skills 发现（推荐）
@@ -126,14 +150,14 @@ Mintlify 在 `/.well-known/skills/` 和 `/.well-known/agent-skills/` 托管了 s
}
```
-| 字段 | 描述 |
-| ---- | ---- |
-| `$schema` | Agent-skills 0.2.0 发现规范的 schema URL。 |
-| `name` | 一个 URL 安全的 slug，源自你 `skill.md` frontmatter 中的 `name` 字段。 |
-| `type` | Skill 格式，始终为 `skill-md`。 |
-| `description` | 来自你 `skill.md` frontmatter 的简要描述。 |
-| `url` | 获取完整 skill 文件的路径。 |
-| `digest` | Skill 文件内容的 `sha256` 哈希值，用于完整性验证。 |
+| 字段 | 描述 |
+| ------------- | ----------------------------------------------------------------------------- |
+| `$schema` | Agent-skills 0.2.0 发现规范的 schema URL。 |
+| `name` | 一个 URL 安全的 slug，源自你 `skill.md` frontmatter 中的 `name` 字段。 |
+| `type` | Skill 格式，始终为 `skill-md`。 |
+| `description` | 来自你 `skill.md` frontmatter 的简要描述，截断为 1024 个字符。 |
+| `url` | 获取完整 skill 文件的路径。 |
+| `digest` | Skill 文件内容的 `sha256` 哈希值，用于完整性验证。 |
`GET /.well-known/agent-skills/{name}/SKILL.md` 返回通过索引中 slugified 名称标识的特定 skill 的 `skill.md` 文件。