Update toolsnaps and docs

JoannaaKL · web-flow · commit ca8e79645ded · 2025-07-23T10:24:12.000Z
diff --git a/README.md b/README.md
@@ -833,10 +833,10 @@ The following sets of tools are available (all are on by default):
   - `repo`: Repository name (string, required)
 
 - **search_code** - Search code
-  - `order`: Sort order (string, optional)
+  - `order`: Sort order for results (string, optional)
   - `page`: Page number for pagination (min 1) (number, optional)
   - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
-  - `q`: Search query using GitHub code search syntax (string, required)
+  - `q`: Search query using GitHub's powerful code search syntax. Examples: 'content:Skill language:Java org:github', 'NOT is:archived language:Python OR language:go'. Supports exact matching, language filters, path filters, and more. (string, required)
   - `sort`: Sort field ('indexed' only) (string, optional)
 
 - **search_repositories** - Search repositories
diff --git a/pkg/github/__toolsnaps__/search_code.snap b/pkg/github/__toolsnaps__/search_code.snap
@@ -3,11 +3,11 @@
     "title": "Search code",
     "readOnlyHint": true
   },
-  "description": "Search for code across GitHub repositories",
+  "description": "🎯 **PREFERRED**: Lexical code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, functions, classes, or specific code patterns. Use this FIRST before trying semantic alternatives - it's faster and more accurate for exact matches.",
   "inputSchema": {
     "properties": {
       "order": {
-        "description": "Sort order",
+        "description": "Sort order for results",
         "enum": [
           "asc",
           "desc"
@@ -26,7 +26,7 @@
         "type": "number"
       },
       "q": {
-        "description": "Search query using GitHub code search syntax",
+        "description": "Search query using GitHub's powerful code search syntax. Examples: 'content:Skill language:Java org:github', 'NOT is:archived language:Python OR language:go'. Supports exact matching, language filters, path filters, and more.",
         "type": "string"
       },
       "sort": {
