Language review

Author: MariaShaposhnikova

content/en/docs/refguide/mendix-ai-assistance/_index.md

@@ -53,7 +53,7 @@ Guidance:
 * **Maia Learn** – helps you to quickly learn Mendix core concepts and get started with Studio Pro. For more information, see [Maia Learn](/refguide/maia-learn/).
 * **Maia Explain** – helps you easily understand a microflow or a nanoflow. It explains the general purpose of the logic and highlights specific technical details to help you understand the logic further. For more information, see [Maia Explain](/refguide/maia-explain/).
 * **Maia Agent Skills** – lets you define modular, reusable instructions that extend Maia with domain-specific knowledge. Maia applies them automatically whenever relevant, eliminating the need to repeat the same context across conversations. For more information, see [Maia Agent Skills](/refguide/maia-agent-skills/).
-* **Maia Agent Instructions** – lets you define project- or module-level instructions (AGENTS.md) that steer agent behavior. Use them to set common context for your prompts, such as company conventions or environment restrictions, so they are automatically included whenever relevant. For more information, see [Maia Agent Instructions](/refguide/maia-instructions/).
+* **Maia Agent Instructions** – allows you to define project- or module-level instructions (AGENTS.md) that steer agent behavior. You can use them to set common context for your prompts, such as company conventions or environment restrictions, so they are automatically included when relevant. For more information, see [Maia Agent Instructions](/refguide/maia-instructions/).
 
 Recommenders:
 

content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-agent-skills.md

@@ -21,7 +21,7 @@ Instead of typing the same context into every chat, you define agent skills once
 
 Use agent skills to equip Maia with the domain knowledge and conventions it needs, whether those are company-wide standards or team-specific workflows. For example, a skill capturing your company's Mendix naming conventions means Maia applies them consistently whenever it generates entities, attributes, or microflows without you having to mention them each time.
 
-Since Studio Pro 11.12, Maia supports not only project-level skills, but also skills for all application (non-protected) modules. These skills are exportable together with the module in which they are contained
+Starting from Studio Pro 11.12, Maia supports not only project-level skills, but also skills for all application (non-protected) modules. These skills are exportable together with the module in which they are kept
 and can help you split your skills better.
 
 For guidance on writing effective skills, see [Best Practices for Skill Creators](https://agentskills.io/skill-creation/best-practices) and [Optimizing Skill Descriptions](https://agentskills.io/skill-creation/optimizing-descriptions) in the [Agent Skills documentation](https://agentskills.io/).
@@ -63,7 +63,7 @@ The `name` field must match the skill's parent directory name exactly. A mismatc
 ### Directory Structure {#directory-structure}
 
 Skills are stored in the `skillssource/` directory at the root of your application directory. You can also manage skills directly in the file system, for example, to copy in skills from another project. After making changes in the file system, go to **App** > **Synchronize App Directory** (keyboard shortcut: <kbd>F4</kbd>) to make the changes visible in Studio Pro. 
-You can also sync the changes by pressing the 'Sync' button in Maia skills overview pane.
+You can also sync the changes by pressing the **Sync** button in the **Maia skills** overview pane.
 
 Project-level skills are stored directly under `skillssource` directory:
 

content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-instructions.md

@@ -36,11 +36,11 @@ Maia supports both [agent skills](/refguide/maia-agent-skills/) and agent instru
 To create a new Maia Instruction, follow these steps:
 
 1. In the **App Explorer**, find either the **Maia** node under **App** for project-level instructions, or the **Maia** node under a module if you wish to add a module-level instruction.
-1. Right-click this node and click **Add** > **Agent instructions**.
+2. Right-click this node and click **Add** > **Agent instructions**.
 
 Studio Pro creates the `AGENTS.md` file. You can continue adding the instruction content.
 
-Note that newly added instructions or changes to existing instructions are discovered only when new session is started.
+{{% alert color="info" %}}Newly added instructions or changes to existing instructions are discovered only when new session is started.{{% /alert %}}
 
 ### Instructions Content {#instructions-content}