Phase 5a: Add search_terms vocabulary to all 18 capabilities

snapsynapse · claude · snapsynapse · commit 7dd949742ec9 · 2026-03-15T17:09:15.000-06:00
Adds SEO search vocabulary to every capability record, bridging
ontology language to natural user search terms. Wires search_terms
into data export and client-side search index for improved discovery.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/data/capabilities/build-reusable-ai-workflows.md b/data/capabilities/build-reusable-ai-workflows.md
@@ -3,6 +3,12 @@ id: build-reusable-ai-workflows
 name: Build Reusable AI Workflows
 group: connect
 status: active
+search_terms:
+  - custom GPTs
+  - AI workflows
+  - custom bots
+  - reusable prompts
+  - AI automation builder
 ---
 
 ## Summary
diff --git a/data/capabilities/connect-to-external-systems.md b/data/capabilities/connect-to-external-systems.md
@@ -3,6 +3,12 @@ id: connect-to-external-systems
 name: Connect to External Systems
 group: connect
 status: active
+search_terms:
+  - AI integrations
+  - API access
+  - connect apps
+  - third party plugins
+  - external tools
 ---
 
 ## Summary
diff --git a/data/capabilities/do-multi-step-research.md b/data/capabilities/do-multi-step-research.md
@@ -3,6 +3,12 @@ id: do-multi-step-research
 name: Do Multi-Step Research
 group: act-for-me
 status: active
+search_terms:
+  - deep research
+  - AI research assistant
+  - multi-step research
+  - research agent
+  - comprehensive research
 ---
 
 ## Summary
diff --git a/data/capabilities/generate-images.md b/data/capabilities/generate-images.md
@@ -3,6 +3,13 @@ id: generate-images
 name: Generate Images
 group: create
 status: active
+search_terms:
+  - AI image generator
+  - create images
+  - text to image
+  - AI art
+  - generate pictures
+  - image creation
 ---
 
 ## Summary
diff --git a/data/capabilities/generate-video.md b/data/capabilities/generate-video.md
@@ -3,6 +3,12 @@ id: generate-video
 name: Generate Video
 group: create
 status: active
+search_terms:
+  - AI video generator
+  - create video
+  - text to video
+  - AI video maker
+  - generate video clips
 ---
 
 ## Summary
diff --git a/data/capabilities/hear-audio-and-speech.md b/data/capabilities/hear-audio-and-speech.md
@@ -3,6 +3,13 @@ id: hear-audio-and-speech
 name: Hear Audio and Speech
 group: understand
 status: active
+search_terms:
+  - voice input
+  - voice mode
+  - speech recognition
+  - talk to AI
+  - audio input
+  - voice chat
 ---
 
 ## Summary
diff --git a/data/capabilities/make-and-edit-documents.md b/data/capabilities/make-and-edit-documents.md
@@ -3,6 +3,12 @@ id: make-and-edit-documents
 name: Make and Edit Documents
 group: create
 status: active
+search_terms:
+  - AI document editor
+  - create documents
+  - edit documents
+  - AI writing assistant
+  - collaborative editing
 ---
 
 ## Summary
diff --git a/data/capabilities/organize-work-in-projects.md b/data/capabilities/organize-work-in-projects.md
@@ -3,6 +3,12 @@ id: organize-work-in-projects
 name: Organize Work in Projects
 group: work-with-my-stuff
 status: active
+search_terms:
+  - AI projects
+  - organize conversations
+  - project folders
+  - workspace organization
+  - group chats
 ---
 
 ## Summary
diff --git a/data/capabilities/read-text-and-documents.md b/data/capabilities/read-text-and-documents.md
@@ -3,6 +3,13 @@ id: read-text-and-documents
 name: Read Text and Documents
 group: understand
 status: active
+search_terms:
+  - upload documents
+  - read PDF
+  - analyze documents
+  - document understanding
+  - file upload
+  - read files
 ---
 
 ## Summary
diff --git a/data/capabilities/remember-context-over-time.md b/data/capabilities/remember-context-over-time.md
@@ -3,6 +3,12 @@ id: remember-context-over-time
 name: Remember Context Over Time
 group: work-with-my-stuff
 status: active
+search_terms:
+  - AI memory
+  - remember conversations
+  - persistent context
+  - long-term memory
+  - remember preferences
 ---
 
 ## Summary
diff --git a/data/capabilities/search-the-web.md b/data/capabilities/search-the-web.md
@@ -3,6 +3,13 @@ id: search-the-web
 name: Search the Web
 group: act-for-me
 status: active
+search_terms:
+  - web search
+  - web browsing
+  - internet access
+  - real-time information
+  - browse the internet
+  - grounding
 ---
 
 ## Summary
diff --git a/data/capabilities/see-images-and-screens.md b/data/capabilities/see-images-and-screens.md
@@ -3,6 +3,13 @@ id: see-images-and-screens
 name: See Images and Screens
 group: understand
 status: active
+search_terms:
+  - image recognition
+  - vision
+  - analyze images
+  - screenshot analysis
+  - image understanding
+  - upload photos
 ---
 
 ## Summary
diff --git a/data/capabilities/speak-back-in-real-time.md b/data/capabilities/speak-back-in-real-time.md
@@ -3,6 +3,13 @@ id: speak-back-in-real-time
 name: Speak Back in Real Time
 group: respond
 status: active
+search_terms:
+  - voice output
+  - text to speech
+  - AI voice
+  - voice response
+  - talk back
+  - spoken answers
 ---
 
 ## Summary
diff --git a/data/capabilities/take-actions-and-run-tools.md b/data/capabilities/take-actions-and-run-tools.md
@@ -3,6 +3,13 @@ id: take-actions-and-run-tools
 name: Take Actions and Run Tools
 group: act-for-me
 status: active
+search_terms:
+  - AI agent
+  - agentic AI
+  - tool use
+  - AI automation
+  - run tasks
+  - computer use
 ---
 
 ## Summary
diff --git a/data/capabilities/use-files-i-provide.md b/data/capabilities/use-files-i-provide.md
@@ -3,6 +3,12 @@ id: use-files-i-provide
 name: Use Files I Provide
 group: work-with-my-stuff
 status: active
+search_terms:
+  - upload files
+  - attach files
+  - file analysis
+  - process files
+  - work with files
 ---
 
 ## Summary
diff --git a/data/capabilities/use-it-on-my-surfaces.md b/data/capabilities/use-it-on-my-surfaces.md
@@ -3,6 +3,12 @@ id: use-it-on-my-surfaces
 name: Use It on My Surfaces
 group: access-context
 status: active
+search_terms:
+  - AI desktop app
+  - mobile app
+  - API access
+  - browser extension
+  - platform availability
 ---
 
 ## Summary
diff --git a/data/capabilities/write-and-edit-code.md b/data/capabilities/write-and-edit-code.md
@@ -3,6 +3,13 @@ id: write-and-edit-code
 name: Write and Edit Code
 group: create
 status: active
+search_terms:
+  - AI code editor
+  - code generation
+  - AI coding assistant
+  - write code
+  - code completion
+  - AI programming
 ---
 
 ## Summary
diff --git a/data/capabilities/write-and-explain.md b/data/capabilities/write-and-explain.md
@@ -3,6 +3,13 @@ id: write-and-explain
 name: Write and Explain
 group: respond
 status: active
+search_terms:
+  - AI chat
+  - ask questions
+  - explain things
+  - write text
+  - answer questions
+  - AI writing
 ---
 
 ## Summary
diff --git a/docs/assets/data.json b/docs/assets/data.json
diff --git a/docs/assets/grok-logo.svg b/docs/assets/grok-logo.svg
diff --git a/docs/assets/search.js b/docs/assets/search.js
@@ -26,13 +26,19 @@
           // Pre-build searchable text for each implementation
           var prodMap = {};
           (index.products || []).forEach(function (p) { prodMap[p.id] = p; });
+          var capSearchMap = {};
+          (index.capabilities || []).forEach(function (c) {
+            capSearchMap[c.id] = (c.searchTerms || []).join(' ');
+          });
           index.implementations.forEach(function (impl) {
             var prod = prodMap[impl.product] || {};
+            var capTerms = (impl.capabilities || []).map(function (cid) { return capSearchMap[cid] || ''; }).join(' ');
             impl._search = [
               impl.name,
               impl.productName || prod.name || '',
               prod.providerName || impl.provider || '',
               (impl.capabilityNames || []).join(' '),
+              capTerms,
               impl.talkingPoint || ''
             ].join(' ').toLowerCase();
           });
diff --git a/scripts/build.js b/scripts/build.js
@@ -2378,6 +2378,7 @@ function buildDataExport(ontologyData) {
         name: c.name,
         group: c.group,
         summary: c.summary || '',
+        searchTerms: c.search_terms || [],
         implementationCount: c.implementation_count || 0,
         productCount: c.product_count || 0
     }));
