diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
index f66522530..6556669c1 100644
--- a/fr/ai/llmstxt.mdx
+++ b/fr/ai/llmstxt.mdx
@@ -37,13 +37,16 @@ La description de chaque page provient du champ `description` de son frontmatter
## Documentation
-- [API](https://example.com/docs/api) : Liste des endpoints et utilisation
-- [Installation](https://example.com/docs/install) : Étapes de configuration
-- [Prise en main](https://example.com/docs/start) : Guide d'introduction
+- [API](https://example.com/docs/api.md) : Liste des endpoints et utilisation
+- [Installation](https://example.com/docs/install.md) : Étapes de configuration
+- [Prise en main](https://example.com/docs/start.md) : Guide d'introduction
-## Spécifications API
+## OpenAPI Specs
- [openapi](https://example.com/docs/openapi.json)
+
+## AsyncAPI Specs
+
- [asyncapi](https://example.com/docs/asyncapi.yaml)
```
diff --git a/fr/ai/markdown-export.mdx b/fr/ai/markdown-export.mdx
index c52350c86..5a8c9a1b0 100644
--- a/fr/ai/markdown-export.mdx
+++ b/fr/ai/markdown-export.mdx
@@ -19,6 +19,14 @@ Ajoutez `.md` à l’URL de n’importe quelle page pour afficher une version Ma
+## En-tête Accept
+
+Envoyez une requête avec `Accept: text/markdown` ou `Accept: text/plain` à n'importe quelle URL de page pour recevoir la version Markdown au lieu du HTML. Cela est utile pour les outils d'IA et les intégrations qui récupèrent le contenu de la documentation de manière programmatique.
+
+```bash
+curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
+```
+
diff --git a/fr/api/assistant/create-assistant-message-v2.mdx b/fr/api/assistant/create-assistant-message-v2.mdx
index df00b958a..f8b172fb4 100644
--- a/fr/api/assistant/create-assistant-message-v2.mdx
+++ b/fr/api/assistant/create-assistant-message-v2.mdx
@@ -16,7 +16,7 @@ keywords:
---
diff --git a/fr/api/assistant/create-assistant-message.mdx b/fr/api/assistant/create-assistant-message.mdx
index 1ccc44be9..979692908 100644
--- a/fr/api/assistant/create-assistant-message.mdx
+++ b/fr/api/assistant/create-assistant-message.mdx
@@ -11,7 +11,7 @@ keywords: [ "message de l’Assistant", "intégration", "chat", "intégrer", "ai
Obsolète
- Le point de terminaison assistant message v1 est compatible avec **AI SDK v4**. Si vous utilisez AI SDK v5 ou une version ultérieure, utilisez plutôt le [point de terminaison assistant message v2](/fr/api-reference/assistant/create-assistant-message-v2).
+ Le point de terminaison assistant message v1 est compatible avec **AI SDK v4**. Si vous utilisez AI SDK v5 ou une version ultérieure, utilisez plutôt le [point de terminaison assistant message v2](/fr/api/assistant/create-assistant-message-v2).
diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx
index e77801acb..c9fa4a7e5 100644
--- a/zh/ai/llmstxt.mdx
+++ b/zh/ai/llmstxt.mdx
@@ -14,7 +14,7 @@ Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文
如果你的站点需要认证，查看 `llms.txt` 和 `llms-full.txt` 也同样需要认证。无法通过你站点认证的 LLM 和 AI 工具将无法访问这些文件。这些文件会排除属于[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面。
-将 `/llms.txt` 追加到你的文档站点 URL 后查看 `llms.txt`。
+将 `/llms.txt` 追加到你的文档站点 URL 后查看 `llms.txt`。Mintlify 还会在 `/.well-known/llms.txt` 托管该文件，以兼容采用 `.well-known` 约定的工具。
打开此站点的 llms.txt。
@@ -37,18 +37,30 @@ Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文
## 文档
-- [API](https://example.com/docs/api): 端点列表和使用方法
-- [安装](https://example.com/docs/install): 设置步骤
-- [快速开始](https://example.com/docs/start): 入门指南
+- [API](https://example.com/docs/api.md): 端点列表和使用方法
+- [安装](https://example.com/docs/install.md): 设置步骤
+- [快速开始](https://example.com/docs/start.md): 入门指南
-## API 规范
+## OpenAPI Specs
- [openapi](https://example.com/docs/openapi.json)
+
+## AsyncAPI Specs
+
- [asyncapi](https://example.com/docs/asyncapi.yaml)
```
+`llms.txt` 文件中的页面链接包含 `.md` 扩展名，以便 AI 工具可以直接获取每个页面的 Markdown 版本。
+
这种结构化方法使 LLM 能够高效地从宏观层面处理你的文档，并为用户查询定位相关内容，从而提升 AI 辅助文档搜索的准确性和速度。
+## 自动发现
+
+Mintlify 会在每个页面响应中添加 HTTP 头，以便 AI 工具自动发现你的 `llms.txt` 文件：
+
+- `Link: ; rel="llms-txt", ; rel="llms-full-txt"` — 遵循标准 HTTP `Link` 头格式进行资源发现。
+- `X-Llms-Txt: /llms.txt` — 一个便捷头，供检查 `llms.txt` 支持的工具使用。
+
## llms-full.txt
diff --git a/zh/ai/markdown-export.mdx b/zh/ai/markdown-export.mdx
index 903bfd967..b037310b7 100644
--- a/zh/ai/markdown-export.mdx
+++ b/zh/ai/markdown-export.mdx
@@ -19,6 +19,14 @@ Mintlify 会自动生成针对 AI 工具和外部 integrations 优化的页面 M
以 Markdown 打开此页面
+## Accept 请求头
+
+发送带有 `Accept: text/markdown` 或 `Accept: text/plain` 的请求到任意页面 URL，即可获取 Markdown 版本而非 HTML。这对于以编程方式获取文档内容的 AI 工具和集成非常有用。
+
+```bash
+curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
+```
+
## 键盘快捷键
diff --git a/zh/ai/skillmd.mdx b/zh/ai/skillmd.mdx
index d2c50acf5..3b8e56b0c 100644
--- a/zh/ai/skillmd.mdx
+++ b/zh/ai/skillmd.mdx
@@ -26,7 +26,7 @@ Mintlify 会通过一个 agentic loop 分析你的文档，自动为你的项目
代理可以使用 [skills 命令行界面 (CLI) ](https://www.npmjs.com/package/skills) 来处理你的 `skill.md`。
@@ -41,6 +41,32 @@ npx skills add https://your-docs-domain.com
向你的用户讲解如何将 `skill.md` 文件与代理配合使用，以便他们在结合你的产品使用 AI 工具时获得更好的效果。
+## Skills 发现端点
+
+Mintlify 在 `/.well-known/skills/` 托管一个 skills 目录，代理可以用它以编程方式发现和获取你的 skill 文件。
+
+### Skills 索引
+
+`GET /.well-known/skills/index.json` 返回一个 JSON 清单，列出所有可用的 skills：
+
+```json
+{
+ "skills": [
+ {
+ "name": "my-product",
+ "description": "你的 skill 功能的简要说明。",
+ "files": ["SKILL.md"]
+ }
+ ]
+}
+```
+
+`name` 字段是从你 `skill.md` frontmatter 中的 `name` 字段派生的 URL 安全 slug。
+
+### 单个 skill 文件
+
+`GET /.well-known/skills/{name}/skill.md` 返回通过索引中的 slugified 名称标识的特定 skill 的 `skill.md` 文件。
+
## `skill.md` 结构
diff --git a/zh/api/assistant/create-assistant-message-v2.mdx b/zh/api/assistant/create-assistant-message-v2.mdx
index 1aec76afe..1ba16a029 100644
--- a/zh/api/assistant/create-assistant-message-v2.mdx
+++ b/zh/api/assistant/create-assistant-message-v2.mdx
@@ -15,7 +15,7 @@ keywords:
---
- assistant 消息 v2 端点兼容 **AI SDK v5+**。如果你正在使用 AI SDK v4，请改用 [assistant 消息 v1 端点](/zh/api-reference/assistant/create-assistant-message)。
+ assistant 消息 v2 端点兼容 **AI SDK v5+**。如果你正在使用 AI SDK v4，请改用 [assistant 消息 v1 端点](/zh/api/assistant/create-assistant-message)。
diff --git a/zh/api/assistant/create-assistant-message.mdx b/zh/api/assistant/create-assistant-message.mdx
index e91912230..4e2073d04 100644
--- a/zh/api/assistant/create-assistant-message.mdx
+++ b/zh/api/assistant/create-assistant-message.mdx
@@ -9,7 +9,7 @@ keywords: [ "AI 助手消息", "嵌入", "聊天", "集成", "ai sdk v4" ]
已废弃
- assistant message v1 端点与 **AI SDK v4** 兼容。若你使用 AI SDK v5 或更高版本，请改用 [assistant message v2 端点](/zh/api-reference/assistant/create-assistant-message-v2)。
+ assistant message v1 端点与 **AI SDK v4** 兼容。若你使用 AI SDK v5 或更高版本，请改用 [assistant message v2 端点](/zh/api/assistant/create-assistant-message-v2)。
From ff21a28bafd17d20c86a42ea8f292b7aa634a3df Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Wed, 18 Mar 2026 15:50:09 -0700
Subject: [PATCH 2/5] Revert translated file changes, keep English-only updates
Co-Authored-By: Claude Sonnet 4.6
---
es/ai/llmstxt.mdx | 22 ++++-----------
es/ai/markdown-export.mdx | 8 ------
es/ai/skillmd.mdx | 28 +------------------
.../assistant/create-assistant-message-v2.mdx | 2 +-
es/api/assistant/create-assistant-message.mdx | 2 +-
fr/ai/llmstxt.mdx | 11 +++-----
fr/ai/markdown-export.mdx | 8 ------
.../assistant/create-assistant-message-v2.mdx | 2 +-
fr/api/assistant/create-assistant-message.mdx | 2 +-
zh/ai/llmstxt.mdx | 22 ++++-----------
zh/ai/markdown-export.mdx | 8 ------
zh/ai/skillmd.mdx | 28 +------------------
.../assistant/create-assistant-message-v2.mdx | 2 +-
zh/api/assistant/create-assistant-message.mdx | 2 +-
14 files changed, 22 insertions(+), 125 deletions(-)
diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx
index c5ccc8f4f..c52a3137e 100644
--- a/es/ai/llmstxt.mdx
+++ b/es/ai/llmstxt.mdx
@@ -14,7 +14,7 @@ Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto
Si tu sitio requiere autenticación, `llms.txt` y `llms-full.txt` también requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. Los archivos excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups).
-Consulta tu `llms.txt` añadiendo `/llms.txt` a la URL de tu sitio de documentación. Mintlify también aloja el archivo en `/.well-known/llms.txt` para garantizar la compatibilidad con herramientas que siguen la convención `.well-known`.
+Consulta tu `llms.txt` añadiendo `/llms.txt` a la URL de tu sitio de documentación.
Abrir el llms.txt de este sitio.
@@ -37,30 +37,18 @@ La descripción de cada página proviene del campo `description` en su frontmatt
## Documentación
-- [API](https://example.com/docs/api.md): Lista de endpoints y uso
-- [Instalar](https://example.com/docs/install.md): Pasos de configuración
-- [Primeros pasos](https://example.com/docs/start.md): Guía de introducción
+- [API](https://example.com/docs/api): Lista de endpoints y uso
+- [Instalar](https://example.com/docs/install): Pasos de configuración
+- [Primeros pasos](https://example.com/docs/start): Guía de introducción
-## OpenAPI Specs
+## Especificaciones de API
- [openapi](https://example.com/docs/openapi.json)
-
-## AsyncAPI Specs
-
- [asyncapi](https://example.com/docs/asyncapi.yaml)
```
-Los enlaces a las páginas en el archivo `llms.txt` incluyen una extensión `.md` para que las herramientas de IA puedan obtener directamente la versión Markdown de cada página.
-
Este enfoque estructurado permite a los LLM procesar tu documentación de forma eficiente a un alto nivel y localizar contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA.
-## Descubrimiento automático
-
-Mintlify añade encabezados HTTP a cada respuesta de página para que las herramientas de IA puedan descubrir automáticamente tus archivos `llms.txt`:
-
-- `Link: ; rel="llms-txt", ; rel="llms-full-txt"` — sigue el formato estándar del encabezado HTTP `Link` para el descubrimiento de recursos.
-- `X-Llms-Txt: /llms.txt` — un encabezado de conveniencia para herramientas que verifican el soporte de `llms.txt`.
-
## llms-full.txt
diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx
index 26c5fb140..561a1e98b 100644
--- a/es/ai/markdown-export.mdx
+++ b/es/ai/markdown-export.mdx
@@ -19,14 +19,6 @@ Añade `.md` a la URL de cualquier página para ver una versión en Markdown.
Abrir esta página como Markdown
-## Encabezado Accept
-
-Envía una solicitud con `Accept: text/markdown` o `Accept: text/plain` a cualquier URL de página para recibir la versión Markdown en lugar de HTML. Esto es útil para herramientas de IA e integraciones que obtienen contenido de documentación de forma programática.
-
-```bash
-curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
-```
-
## Atajo de teclado
diff --git a/es/ai/skillmd.mdx b/es/ai/skillmd.mdx
index 7378e631e..a5f03f4ad 100644
--- a/es/ai/skillmd.mdx
+++ b/es/ai/skillmd.mdx
@@ -26,7 +26,7 @@ Consulta tu `skill.md` añadiendo `/skill.md` a la URL de tu sitio de documentac
Los agentes pueden procesar tu archivo `skill.md` con la [CLI de skills](https://www.npmjs.com/package/skills).
@@ -41,32 +41,6 @@ Esto añade las capacidades de tu producto al contexto del agente para que pueda
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.
-## Endpoints de descubrimiento de skills
-
-Mintlify aloja un directorio de skills en `/.well-known/skills/` que los agentes pueden usar para descubrir y obtener tus archivos de skills de forma programática.
-
-### Índice de skills
-
-`GET /.well-known/skills/index.json` devuelve un manifiesto JSON que lista todos los skills disponibles:
-
-```json
-{
- "skills": [
- {
- "name": "my-product",
- "description": "Una breve descripción de lo que hace tu skill.",
- "files": ["SKILL.md"]
- }
- ]
-}
-```
-
-El campo `name` es un slug compatible con URL derivado del campo `name` en el frontmatter de tu `skill.md`.
-
-### Archivos de skills individuales
-
-`GET /.well-known/skills/{name}/skill.md` devuelve el archivo `skill.md` para un skill específico identificado por su nombre slugificado del índice.
-
## Estructura de `skill.md`
diff --git a/es/api/assistant/create-assistant-message-v2.mdx b/es/api/assistant/create-assistant-message-v2.mdx
index c41816ed0..218d0edbe 100644
--- a/es/api/assistant/create-assistant-message-v2.mdx
+++ b/es/api/assistant/create-assistant-message-v2.mdx
@@ -16,7 +16,7 @@ keywords:
---
- El endpoint de mensaje de assistant v2 es compatible con **AI SDK v5 o superior**. Si usas AI SDK v4, utiliza en su lugar el [endpoint de mensaje de assistant v1](/es/api/assistant/create-assistant-message).
+ El endpoint de mensaje de assistant v2 es compatible con **AI SDK v5 o superior**. Si usas AI SDK v4, utiliza en su lugar el [endpoint de mensaje de assistant v1](/es/api-reference/assistant/create-assistant-message).
diff --git a/es/api/assistant/create-assistant-message.mdx b/es/api/assistant/create-assistant-message.mdx
index 646f94298..c0ca20a7d 100644
--- a/es/api/assistant/create-assistant-message.mdx
+++ b/es/api/assistant/create-assistant-message.mdx
@@ -10,7 +10,7 @@ keywords: [ "mensaje del assistant", "incrustar", "chat", "integrar", "ai sdk v4
En desuso
- El endpoint assistant message v1 es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, usa en su lugar el [endpoint assistant message v2](/es/api/assistant/create-assistant-message-v2).
+ El endpoint assistant message v1 es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, usa en su lugar el [endpoint assistant message v2](/es/api-reference/assistant/create-assistant-message-v2).
diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
index 6556669c1..f66522530 100644
--- a/fr/ai/llmstxt.mdx
+++ b/fr/ai/llmstxt.mdx
@@ -37,16 +37,13 @@ La description de chaque page provient du champ `description` de son frontmatter
## Documentation
-- [API](https://example.com/docs/api.md) : Liste des endpoints et utilisation
-- [Installation](https://example.com/docs/install.md) : Étapes de configuration
-- [Prise en main](https://example.com/docs/start.md) : Guide d'introduction
+- [API](https://example.com/docs/api) : Liste des endpoints et utilisation
+- [Installation](https://example.com/docs/install) : Étapes de configuration
+- [Prise en main](https://example.com/docs/start) : Guide d'introduction
-## OpenAPI Specs
+## Spécifications API
- [openapi](https://example.com/docs/openapi.json)
-
-## AsyncAPI Specs
-
- [asyncapi](https://example.com/docs/asyncapi.yaml)
```
diff --git a/fr/ai/markdown-export.mdx b/fr/ai/markdown-export.mdx
index 5a8c9a1b0..c52350c86 100644
--- a/fr/ai/markdown-export.mdx
+++ b/fr/ai/markdown-export.mdx
@@ -19,14 +19,6 @@ Ajoutez `.md` à l’URL de n’importe quelle page pour afficher une version Ma
Ouvrir cette page au format Markdown
-## En-tête Accept
-
-Envoyez une requête avec `Accept: text/markdown` ou `Accept: text/plain` à n'importe quelle URL de page pour recevoir la version Markdown au lieu du HTML. Cela est utile pour les outils d'IA et les intégrations qui récupèrent le contenu de la documentation de manière programmatique.
-
-```bash
-curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
-```
-
## Raccourci clavier
diff --git a/fr/api/assistant/create-assistant-message-v2.mdx b/fr/api/assistant/create-assistant-message-v2.mdx
index f8b172fb4..df00b958a 100644
--- a/fr/api/assistant/create-assistant-message-v2.mdx
+++ b/fr/api/assistant/create-assistant-message-v2.mdx
@@ -16,7 +16,7 @@ keywords:
---
- L'endpoint assistant message v2 est compatible avec **AI SDK v5+**. Si vous utilisez l'AI SDK v4, utilisez plutôt l'[endpoint assistant message v1](/fr/api/assistant/create-assistant-message).
+ L'endpoint assistant message v2 est compatible avec **AI SDK v5+**. Si vous utilisez l'AI SDK v4, utilisez plutôt l'[endpoint assistant message v1](/fr/api-reference/assistant/create-assistant-message).
diff --git a/fr/api/assistant/create-assistant-message.mdx b/fr/api/assistant/create-assistant-message.mdx
index 979692908..1ccc44be9 100644
--- a/fr/api/assistant/create-assistant-message.mdx
+++ b/fr/api/assistant/create-assistant-message.mdx
@@ -11,7 +11,7 @@ keywords: [ "message de l’Assistant", "intégration", "chat", "intégrer", "ai
Obsolète
- Le point de terminaison assistant message v1 est compatible avec **AI SDK v4**. Si vous utilisez AI SDK v5 ou une version ultérieure, utilisez plutôt le [point de terminaison assistant message v2](/fr/api/assistant/create-assistant-message-v2).
+ Le point de terminaison assistant message v1 est compatible avec **AI SDK v4**. Si vous utilisez AI SDK v5 ou une version ultérieure, utilisez plutôt le [point de terminaison assistant message v2](/fr/api-reference/assistant/create-assistant-message-v2).
diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx
index c9fa4a7e5..e77801acb 100644
--- a/zh/ai/llmstxt.mdx
+++ b/zh/ai/llmstxt.mdx
@@ -14,7 +14,7 @@ Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文
如果你的站点需要认证，查看 `llms.txt` 和 `llms-full.txt` 也同样需要认证。无法通过你站点认证的 LLM 和 AI 工具将无法访问这些文件。这些文件会排除属于[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面。
-将 `/llms.txt` 追加到你的文档站点 URL 后查看 `llms.txt`。Mintlify 还会在 `/.well-known/llms.txt` 托管该文件，以兼容采用 `.well-known` 约定的工具。
+将 `/llms.txt` 追加到你的文档站点 URL 后查看 `llms.txt`。
打开此站点的 llms.txt。
@@ -37,30 +37,18 @@ Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文
## 文档
-- [API](https://example.com/docs/api.md): 端点列表和使用方法
-- [安装](https://example.com/docs/install.md): 设置步骤
-- [快速开始](https://example.com/docs/start.md): 入门指南
+- [API](https://example.com/docs/api): 端点列表和使用方法
+- [安装](https://example.com/docs/install): 设置步骤
+- [快速开始](https://example.com/docs/start): 入门指南
-## OpenAPI Specs
+## API 规范
- [openapi](https://example.com/docs/openapi.json)
-
-## AsyncAPI Specs
-
- [asyncapi](https://example.com/docs/asyncapi.yaml)
```
-`llms.txt` 文件中的页面链接包含 `.md` 扩展名，以便 AI 工具可以直接获取每个页面的 Markdown 版本。
-
这种结构化方法使 LLM 能够高效地从宏观层面处理你的文档，并为用户查询定位相关内容，从而提升 AI 辅助文档搜索的准确性和速度。
-## 自动发现
-
-Mintlify 会在每个页面响应中添加 HTTP 头，以便 AI 工具自动发现你的 `llms.txt` 文件：
-
-- `Link: ; rel="llms-txt", ; rel="llms-full-txt"` — 遵循标准 HTTP `Link` 头格式进行资源发现。
-- `X-Llms-Txt: /llms.txt` — 一个便捷头，供检查 `llms.txt` 支持的工具使用。
-
## llms-full.txt
diff --git a/zh/ai/markdown-export.mdx b/zh/ai/markdown-export.mdx
index b037310b7..903bfd967 100644
--- a/zh/ai/markdown-export.mdx
+++ b/zh/ai/markdown-export.mdx
@@ -19,14 +19,6 @@ Mintlify 会自动生成针对 AI 工具和外部 integrations 优化的页面 M
以 Markdown 打开此页面
-## Accept 请求头
-
-发送带有 `Accept: text/markdown` 或 `Accept: text/plain` 的请求到任意页面 URL，即可获取 Markdown 版本而非 HTML。这对于以编程方式获取文档内容的 AI 工具和集成非常有用。
-
-```bash
-curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
-```
-
## 键盘快捷键
diff --git a/zh/ai/skillmd.mdx b/zh/ai/skillmd.mdx
index 3b8e56b0c..d2c50acf5 100644
--- a/zh/ai/skillmd.mdx
+++ b/zh/ai/skillmd.mdx
@@ -26,7 +26,7 @@ Mintlify 会通过一个 agentic loop 分析你的文档，自动为你的项目
代理可以使用 [skills 命令行界面 (CLI) ](https://www.npmjs.com/package/skills) 来处理你的 `skill.md`。
@@ -41,32 +41,6 @@ npx skills add https://your-docs-domain.com
向你的用户讲解如何将 `skill.md` 文件与代理配合使用，以便他们在结合你的产品使用 AI 工具时获得更好的效果。
-## Skills 发现端点
-
-Mintlify 在 `/.well-known/skills/` 托管一个 skills 目录，代理可以用它以编程方式发现和获取你的 skill 文件。
-
-### Skills 索引
-
-`GET /.well-known/skills/index.json` 返回一个 JSON 清单，列出所有可用的 skills：
-
-```json
-{
- "skills": [
- {
- "name": "my-product",
- "description": "你的 skill 功能的简要说明。",
- "files": ["SKILL.md"]
- }
- ]
-}
-```
-
-`name` 字段是从你 `skill.md` frontmatter 中的 `name` 字段派生的 URL 安全 slug。
-
-### 单个 skill 文件
-
-`GET /.well-known/skills/{name}/skill.md` 返回通过索引中的 slugified 名称标识的特定 skill 的 `skill.md` 文件。
-
## `skill.md` 结构
diff --git a/zh/api/assistant/create-assistant-message-v2.mdx b/zh/api/assistant/create-assistant-message-v2.mdx
index 1ba16a029..1aec76afe 100644
--- a/zh/api/assistant/create-assistant-message-v2.mdx
+++ b/zh/api/assistant/create-assistant-message-v2.mdx
@@ -15,7 +15,7 @@ keywords:
---
- assistant 消息 v2 端点兼容 **AI SDK v5+**。如果你正在使用 AI SDK v4，请改用 [assistant 消息 v1 端点](/zh/api/assistant/create-assistant-message)。
+ assistant 消息 v2 端点兼容 **AI SDK v5+**。如果你正在使用 AI SDK v4，请改用 [assistant 消息 v1 端点](/zh/api-reference/assistant/create-assistant-message)。
diff --git a/zh/api/assistant/create-assistant-message.mdx b/zh/api/assistant/create-assistant-message.mdx
index 4e2073d04..e91912230 100644
--- a/zh/api/assistant/create-assistant-message.mdx
+++ b/zh/api/assistant/create-assistant-message.mdx
@@ -9,7 +9,7 @@ keywords: [ "AI 助手消息", "嵌入", "聊天", "集成", "ai sdk v4" ]
已废弃
- assistant message v1 端点与 **AI SDK v4** 兼容。若你使用 AI SDK v5 或更高版本，请改用 [assistant message v2 端点](/zh/api/assistant/create-assistant-message-v2)。
+ assistant message v1 端点与 **AI SDK v4** 兼容。若你使用 AI SDK v5 或更高版本，请改用 [assistant message v2 端点](/zh/api-reference/assistant/create-assistant-message-v2)。
From b9bf070cdcb8a07511dcfe91d83138fdbe8e0fab Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Wed, 18 Mar 2026 15:57:13 -0700
Subject: [PATCH 3/5] Apply suggestion from @ethanpalm
---
ai/llmstxt.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
index ae1bf7504..1fcd58711 100644
--- a/ai/llmstxt.mdx
+++ b/ai/llmstxt.mdx
@@ -54,7 +54,7 @@ This structured approach allows LLMs to efficiently process your documentation a
## Automatic discovery
-Mintlify adds HTTP headers to every page response so AI tools can automatically discover your `llms.txt` files without prior knowledge of their location:
+Mintlify adds HTTP headers to every page response so AI tools can discover your `llms.txt` files without prior knowledge of their location:
- `Link: ; rel="llms-txt", ; rel="llms-full-txt"` — follows the standard HTTP `Link` header format for resource discovery.
- `X-Llms-Txt: /llms.txt` — a convenience header for tools that check for `llms.txt` support.
From 903a5bf3d07e1c4994cf8a6ea2db2e14593f7ae0 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Wed, 18 Mar 2026 15:59:32 -0700
Subject: [PATCH 4/5] Update llmstxt.mdx
---
ai/llmstxt.mdx | 20 ++++++++------------
1 file changed, 8 insertions(+), 12 deletions(-)
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
index 1fcd58711..cff20ca29 100644
--- a/ai/llmstxt.mdx
+++ b/ai/llmstxt.mdx
@@ -18,6 +18,11 @@ View your `llms.txt` by appending `/llms.txt` to your documentation site's URL.
Open the llms.txt for this site.
+Mintlify adds HTTP headers to every page response so AI tools can discover your `llms.txt` files without prior knowledge of their location:
+
+- `Link: ; rel="llms-txt", ; rel="llms-full-txt"`: Follows the standard HTTP `Link` header format for resource discovery.
+- `X-Llms-Txt: /llms.txt`: A convenience header for tools that check for `llms.txt` support.
+
## llms.txt structure
An `llms.txt` file is a plain Markdown file that contains:
@@ -26,10 +31,12 @@ An `llms.txt` file is a plain Markdown file that contains:
- **Structured content sections** with links and a description of each page in your documentation.
- **API specification links** to your OpenAPI and AsyncAPI specs, if your documentation includes them.
-The `llms.txt` file lists your pages alphabetically in the order they appear in your repository, starting from the root directory.
+The `llms.txt` file lists your pages alphabetically in the order they appear in your repository, starting from the root directory. Page links in the `llms.txt` file include a `.md` extension so AI tools can fetch the Markdown version of each page directly.
Each page's description comes from the `description` field in its frontmatter. Descriptions truncate at 300 characters and the first line break. For API reference pages, the description also includes the specification information from the `openapi` or `api` frontmatter field. Pages without a `description` field appear in the `llms.txt` file without a description.
+This structured approach allows LLMs to efficiently process your documentation at a high level and locate relevant content for user queries, improving the accuracy and speed of AI-assisted documentation searches.
+
```mdx Example llms.txt
# Site title
@@ -48,17 +55,6 @@ Each page's description comes from the `description` field in its frontmatter. D
- [asyncapi](https://example.com/docs/asyncapi.yaml)
```
-Page links in the `llms.txt` file include a `.md` extension so AI tools can fetch the Markdown version of each page directly.
-
-This structured approach allows LLMs to efficiently process your documentation at a high level and locate relevant content for user queries, improving the accuracy and speed of AI-assisted documentation searches.
-
-## Automatic discovery
-
-Mintlify adds HTTP headers to every page response so AI tools can discover your `llms.txt` files without prior knowledge of their location:
-
-- `Link: ; rel="llms-txt", ; rel="llms-full-txt"` — follows the standard HTTP `Link` header format for resource discovery.
-- `X-Llms-Txt: /llms.txt` — a convenience header for tools that check for `llms.txt` support.
-
## llms-full.txt
The `llms-full.txt` file combines your entire documentation site into a single file as context for AI tools and LLM indexing.
From 3a6d018c2aaad1773e698da89effcd31d29ff4a5 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Wed, 18 Mar 2026 16:02:00 -0700
Subject: [PATCH 5/5] Update skillmd.mdx
---
ai/skillmd.mdx | 54 +++++++++++++++++++++++++-------------------------
1 file changed, 27 insertions(+), 27 deletions(-)
diff --git a/ai/skillmd.mdx b/ai/skillmd.mdx
index df001329d..3acf58463 100644
--- a/ai/skillmd.mdx
+++ b/ai/skillmd.mdx
@@ -39,32 +39,6 @@ This adds your product's capabilities to the agent's context so it can take acti
Teach your users how to use `skill.md` files with agents so that they have better results using your product with their AI tools.
-## Skills discovery endpoints
-
-Mintlify hosts a skills directory at `/.well-known/skills/` that agents can use to discover and fetch your skill files programmatically.
-
-### Skills index
-
-`GET /.well-known/skills/index.json` returns a JSON manifest listing all available skills:
-
-```json
-{
- "skills": [
- {
- "name": "my-product",
- "description": "A brief description of what your skill does.",
- "files": ["SKILL.md"]
- }
- ]
-}
-```
-
-The `name` field is a URL-safe slug derived from the `name` in your `skill.md` frontmatter.
-
-### Individual skill files
-
-`GET /.well-known/skills/{name}/skill.md` returns the `skill.md` file for a specific skill identified by its slugified name from the index.
-
## `skill.md` structure
Mintlify generates a `skill.md` file following the [agentskills.io specification](https://agentskills.io/specification). The generated file includes:
@@ -105,4 +79,30 @@ metadata:
author: mintlify
version: "1.0"
---
-```
\ No newline at end of file
+```
+
+## Skills discovery endpoints
+
+Mintlify hosts a skills directory at `/.well-known/skills/` that agents can use to discover and fetch your skill files programmatically.
+
+### Skills index
+
+`GET /.well-known/skills/index.json` returns a JSON manifest listing all available skills:
+
+```json
+{
+ "skills": [
+ {
+ "name": "my-product",
+ "description": "A brief description of what your skill does.",
+ "files": ["SKILL.md"]
+ }
+ ]
+}
+```
+
+The `name` field is a URL-safe slug derived from the `name` in your `skill.md` frontmatter.
+
+### Individual skill files
+
+`GET /.well-known/skills/{name}/skill.md` returns the `skill.md` file for a specific skill identified by its slugified name from the index.