diff --git a/agent/slack.mdx b/agent/slack.mdx
index 801e6e324..7ac2361e5 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
 <Warning>
   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/<your-org-id>/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/<your-org-id>/integrations/installed`). Find the `mintlify` app and install it to your workspace.
 </Warning>
 
 ### Reconnect or reinstall the agent
diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx
index de72258cd..27cd50f70 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.
 
 <Tip>
-  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.
 </Tip>
 
 ## Menu options
diff --git a/ai/skillmd.mdx b/ai/skillmd.mdx
index 524ba1274..d010dc5a6 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.