diff --git a/pkg/github/__toolsnaps__/search_issues.snap b/pkg/github/__toolsnaps__/search_issues.snap
index a2ec55b911..2c056c0cfd 100644
--- a/pkg/github/__toolsnaps__/search_issues.snap
+++ b/pkg/github/__toolsnaps__/search_issues.snap
@@ -4,7 +4,7 @@
     "readOnlyHint": true,
     "title": "Search issues"
   },
-  "description": "Search for issues in GitHub repositories using issues search syntax already scoped to is:issue",
+  "description": "Search issues using natural-language semantic matching. Best for conceptual or paraphrased queries (e.g. \"login fails after password reset\"). Already scoped to is:issue. Avoid boolean OR operators, which fall back to lexical search.",
   "inputSchema": {
     "properties": {
       "order": {
@@ -31,7 +31,7 @@
         "type": "number"
       },
       "query": {
-        "description": "Search query using GitHub issues search syntax",
+        "description": "The search query. Write it as natural language for semantic and hybrid variants.",
         "type": "string"
       },
       "repo": {
diff --git a/pkg/github/__toolsnaps__/search_issues_ff_fields_param.snap b/pkg/github/__toolsnaps__/search_issues_ff_fields_param.snap
index f705f14725..2c1637e173 100644
--- a/pkg/github/__toolsnaps__/search_issues_ff_fields_param.snap
+++ b/pkg/github/__toolsnaps__/search_issues_ff_fields_param.snap
@@ -4,7 +4,7 @@
     "readOnlyHint": true,
     "title": "Search issues"
   },
-  "description": "Search for issues in GitHub repositories using issues search syntax already scoped to is:issue",
+  "description": "Search issues using natural-language semantic matching. Best for conceptual or paraphrased queries (e.g. \"login fails after password reset\"). Already scoped to is:issue. Avoid boolean OR operators, which fall back to lexical search.",
   "inputSchema": {
     "properties": {
       "fields": {
@@ -64,7 +64,7 @@
         "type": "number"
       },
       "query": {
-        "description": "Search query using GitHub issues search syntax",
+        "description": "The search query. Write it as natural language for semantic and hybrid variants.",
         "type": "string"
       },
       "repo": {
diff --git a/pkg/github/issues.go b/pkg/github/issues.go
index 0f12804a59..fef52de7dd 100644
--- a/pkg/github/issues.go
+++ b/pkg/github/issues.go
@@ -1628,7 +1628,7 @@ func searchIssuesTool(t translations.TranslationHelperFunc, includeFields bool)
 		Properties: map[string]*jsonschema.Schema{
 			"query": {
 				Type:        "string",
-				Description: "Search query using GitHub issues search syntax",
+				Description: "The search query. Write it as natural language for semantic and hybrid variants.",
 			},
 			"owner": {
 				Type:        "string",
@@ -1675,7 +1675,7 @@ func searchIssuesTool(t translations.TranslationHelperFunc, includeFields bool)
 		ToolsetMetadataIssues,
 		mcp.Tool{
 			Name:        "search_issues",
-			Description: t("TOOL_SEARCH_ISSUES_DESCRIPTION", "Search for issues in GitHub repositories using issues search syntax already scoped to is:issue"),
+			Description: t("TOOL_SEARCH_ISSUES_DESCRIPTION", "Search issues using natural-language semantic matching. Best for conceptual or paraphrased queries (e.g. \"login fails after password reset\"). Already scoped to is:issue. Avoid boolean OR operators, which fall back to lexical search."),
 			Annotations: &mcp.ToolAnnotations{
 				Title:        t("TOOL_SEARCH_ISSUES_USER_TITLE", "Search issues"),
 				ReadOnlyHint: true,