From 74947299884de99f149247f731c8ffd0fc12630a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 00:06:53 +0000 Subject: [PATCH 1/2] docs: split overly long sentences in agent and AI pages for readability --- agent/slack.mdx | 2 +- ai/contextual-menu.mdx | 2 +- ai/skillmd.mdx | 2 +- tmp/scan.cjs | 22 ++++++++++++++++++++++ 4 files changed, 25 insertions(+), 3 deletions(-) create mode 100644 tmp/scan.cjs diff --git a/agent/slack.mdx b/agent/slack.mdx index 801e6e3240..7ac2361e52 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -33,7 +33,7 @@ Use the agent in Slack to update your content, ask questions, and capture team k On Slack Enterprise Grid, you must install the app to the specific workspace where you want to use the agent. If you skip this step, the agent appears available at the organization level but does not respond in your workspace. - To add the app to a workspace, open your organization's app management page (a URL like `https://app.slack.com/manage//integrations/installed`), find the `mintlify` app, and install it to your workspace. + To add the app to a workspace, open your organization's app management page (a URL like `https://app.slack.com/manage//integrations/installed`). Find the `mintlify` app and install it to your workspace. ### Reconnect or reinstall the agent diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index de72258cd5..27cd50f70a 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -10,7 +10,7 @@ import IconsRequired from "/snippets/icons-required.mdx"; The contextual menu provides quick access to AI-optimized content and direct integrations with popular AI tools. When users click the contextual menu on any page, they can copy content as context for AI tools or open it in an AI conversation. Supported tools include ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Devin Desktop, and any custom tool you configure. - Pair the contextual menu with your hosted [`skill.md`](/ai/skillmd) file and [MCP server](/ai/model-context-protocol) so that users can install your product's full capabilities into their AI tools, not just the page they are reading. + Pair the contextual menu with your hosted [`skill.md`](/ai/skillmd) file and [MCP server](/ai/model-context-protocol). This lets users install your product's full capabilities into their AI tools, not just the page they are reading. ## Menu options diff --git a/ai/skillmd.mdx b/ai/skillmd.mdx index 524ba12741..d010dc5a69 100644 --- a/ai/skillmd.mdx +++ b/ai/skillmd.mdx @@ -7,7 +7,7 @@ boost: 3 Mintlify hosts a `skill.md` file at the root of your project that describes what AI agents can do with your product. -The [skill.md specification](https://agentskills.io/specification) is a structured, machine-readable format that makes capabilities, required inputs, and constraints for products explicit so that agents can use them more reliably. +The [skill.md specification](https://agentskills.io/specification) is a structured, machine-readable format that makes product capabilities, required inputs, and constraints explicit. Agents can then use those products more reliably. Mintlify automatically generates a `skill.md` file for your project by analyzing your documentation with an agentic loop. This file stays up to date as you make updates to your documentation and requires no maintenance. You can optionally add a custom `skill.md` file to the root of your project that overrides the automatically generated one. diff --git a/tmp/scan.cjs b/tmp/scan.cjs new file mode 100644 index 0000000000..958584d944 --- /dev/null +++ b/tmp/scan.cjs @@ -0,0 +1,22 @@ +const fs = require("fs"); +const path = require("path"); +const dirs = ["agent","ai","assistant"]; +const files = []; +for (const d of dirs) for (const f of fs.readdirSync(d)) if (f.endsWith(".mdx")) files.push(path.join(d,f)); +for (const p of files) { + let text = fs.readFileSync(p,"utf8"); + text = text.replace(/^---[\s\S]*?---\n/, ""); + text = text.replace(/```[\s\S]*?```/g, ""); + text = text.replace(/<[^>]+>/g, ""); + const lines = text.split("\n"); + lines.forEach((line, idx) => { + line = line.trim(); + if (!line) return; + if (/^(#|[-*|]|\d+\.)/.test(line)) return; + const sents = line.split(/(?<=[.!?])\s+/); + for (const s of sents) { + const words = (s.match(/\b[\w'-]+\b/g) || []); + if (words.length > 30) console.log(`${p}:${idx+1} [${words.length}w] ${s.slice(0,260)}`); + } + }); +} From ea68e623e6f46531bbfabb88fd7d74379c6078d9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 00:07:09 +0000 Subject: [PATCH 2/2] chore: remove stray tmp scan script --- tmp/scan.cjs | 22 ---------------------- 1 file changed, 22 deletions(-) delete mode 100644 tmp/scan.cjs diff --git a/tmp/scan.cjs b/tmp/scan.cjs deleted file mode 100644 index 958584d944..0000000000 --- a/tmp/scan.cjs +++ /dev/null @@ -1,22 +0,0 @@ -const fs = require("fs"); -const path = require("path"); -const dirs = ["agent","ai","assistant"]; -const files = []; -for (const d of dirs) for (const f of fs.readdirSync(d)) if (f.endsWith(".mdx")) files.push(path.join(d,f)); -for (const p of files) { - let text = fs.readFileSync(p,"utf8"); - text = text.replace(/^---[\s\S]*?---\n/, ""); - text = text.replace(/```[\s\S]*?```/g, ""); - text = text.replace(/<[^>]+>/g, ""); - const lines = text.split("\n"); - lines.forEach((line, idx) => { - line = line.trim(); - if (!line) return; - if (/^(#|[-*|]|\d+\.)/.test(line)) return; - const sents = line.split(/(?<=[.!?])\s+/); - for (const s of sents) { - const words = (s.match(/\b[\w'-]+\b/g) || []); - if (words.length > 30) console.log(`${p}:${idx+1} [${words.length}w] ${s.slice(0,260)}`); - } - }); -}