diff --git a/docs/deep-search/index.mdx b/docs/deep-search/index.mdx
index f9ff24d13..9d8e75f34 100644
--- a/docs/deep-search/index.mdx
+++ b/docs/deep-search/index.mdx
@@ -35,6 +35,13 @@ The answer is formatted in Markdown and can include links to relevant files, dir
 - Provide reasonably scoped questions. The agent will perform much better if it does not have to read the entire codebase at once.
 - Check the list of sources. This is extremely useful for debugging and understanding where the answer came from. Ask a follow-up question and mention the missing source if something is missing.
 
+## Customization
+
+Most organizations will also have specific conventions, technologies, and preferences. Deep Search may discover some of these conventions in its research, but you can also improve performance by customizing it with skills and `AGENTS.md`-style guidance, available on a per-user, per-organization, or global level in settings:
+
+- **User settings → Deep Search → Agents**
+- **Administration → Deep Search → Agents**
+
 ## Using search contexts
 
 You can reuse the same [search contexts](/code-search/working/search-contexts) you already use in Code Search when creating a new Deep Search query. Click **Set scope** in the composer to select a search context and limit Deep Search to that repository scope. Deep Search automatically pre-selects your default search context.