Add information about custom skills

Author: petarvukmirovic

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

@@ -21,15 +21,19 @@ 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
+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/).
 
 ## Creating an Agent Skill {#creating-a-skill}
 
 To create a new agent skill in Studio Pro, follow these steps:
 
-1. In the **App Explorer**, expand **Maia** > **skills**.
-2. Right-click **skills** and click **Add** > **Skill**.
-3. Enter a name for the skill.
+1. In the **App Explorer**, find either the **Maia** node under **App** for project-level skills, or **Maia** node under a module if you wish to add skills for a module.
+1. Expand this node to **Maia** > **skills**.
+1. Right-click **skills** and click **Add** > **Skill**.
+1. Enter a name for the skill.
 
 Studio Pro creates the `SKILL.md` file. You can continue adding the skill content.
 
@@ -60,6 +64,8 @@ The `name` field must match the skill's parent directory name exactly. A mismatc
 
 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.
 
+Project-level skills are stored directly under `skillssource` directory:
+
 ```
 skillssource/
   your-skill/
@@ -69,13 +75,26 @@ skillssource/
       NOTES.md
 ```
 
+Skills for particular modules are stored under `_modules` subdirectory:
+
+```
+skillssource/
+  _modules/
+    <module_name>/
+      your-skill/
+        SKILL.md
+        references/
+          GLOSSARY.md
+          NOTES.md
+```
+
 ## Adding Reference Files {#reference-files}
 
 Reference files let you keep your skill focused by moving supplementary content into separate documents, such as a glossary of domain terms, a data dictionary, or detailed architecture notes. Maia accesses reference file content on demand, only when relevant to your request.
 
 To add a reference file to a skill, follow these steps:
 
-1. In the **App Explorer**, under **Maia** > **skills**, right-click the skill you want to add a reference to.
+1. In the **App Explorer**, under **Maia** > **skills** (either under **App** or for a particular module), right-click the skill you want to add a reference to.
 2. Click **Add** > **Reference**.
 3. Enter a name for the reference file.
 
@@ -85,6 +104,8 @@ For more information on how skills and reference files load, and when they apply
 
 At the start of each chat session, Maia becomes aware of all agent skills in your project. As you work, Maia picks up the relevant skill content automatically. You do not need to reference or invoke skills explicitly.
 
+Make sure to provide informative description of a skill as this is the only information Maia uses to decide whether to read your skill.
+
 If you add or edit a skill while a session is active, those changes take effect the next time you start a chat.
 
 ## Limitations {#limitations}