diff --git a/agent/effective-prompts.mdx b/agent/effective-prompts.mdx
index 2bd9ae82e..ff8aaad7a 100644
--- a/agent/effective-prompts.mdx
+++ b/agent/effective-prompts.mdx
@@ -22,6 +22,34 @@ Use broad prompts for general content maintenance like fixing typos, updating re
 - `@mintlify Find and fix all typos in the docs`
 - `@mintlify change all unordered lists to use * instead of -`
 
+## Reference files and folders with `@` mentions
+
+When you prompt the agent from the dashboard agent panel, type `@` to open an autocomplete menu of files and folders from your documentation. Selecting an item attaches it to your message as context, so the agent knows exactly which content you want it to use or update.
+
+Use `@` mentions to:
+
+- Point the agent at a specific page when a description would be ambiguous.
+- Scope a broad task to a single folder, such as a product area or section.
+- Combine multiple files in one prompt without describing each path in prose.
+
+To attach a file or folder:
+
+1. In the agent panel composer, type `@` followed by the name of the file or folder you want to reference.
+2. Use the arrow keys to highlight an item in the autocomplete list.
+3. Press <kbd>Enter</kbd> or <kbd>Tab</kbd> to attach it. Press <kbd>Esc</kbd> to dismiss the menu.
+
+The attached file or folder appears as a chip above the composer. You can attach multiple items in the same message and remove any chip before sending.
+
+Attached items are passed to the agent as labeled context with their paths, so you can reference them naturally in your prompt:
+
+- `Update @quickstart with the new collaborator invite flow`
+- `Review every page in @api-reference for outdated response examples`
+- `Move @authentication into the new @security folder and update internal links`
+
+<Tip>
+  `@` mentions are available in the agent panel composer in the dashboard. In Slack, attach context by replying in a thread, sharing pull request links, or uploading files directly to your message.
+</Tip>
+
 ## Specify a domain name for multi-site organizations
 
 If you have multiple documentation sites, include the `subdomain` parameter in your message to specify which documentation set the agent should work on.
diff --git a/agent/index.mdx b/agent/index.mdx
index 179be5d8f..81d523ec2 100644
--- a/agent/index.mdx
+++ b/agent/index.mdx
@@ -34,6 +34,7 @@ Use the agent to:
 - Address code review feedback to maintain documentation quality.
 - Capture knowledge from Slack conversations and pull requests before it gets lost.
 - Navigate and coordinate changes across multiple files and directories efficiently.
+- Reference specific files and folders with `@` mentions in the dashboard agent panel to scope requests precisely.
 
 ## Connect your GitHub account