couchbase-fts

Design and troubleshoot Couchbase full text and vector search indexes.

4|1|Updated May 28, 2026
One-click install
npx skills add https://github.com/celticht32/Couchbase-Skills-for-Claude.ai --skill couchbase-fts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: couchbase-fts
Source: https://github.com/celticht32/Couchbase-Skills-for-Claude.ai/tree/main/skills/couchbase/couchbase-fts
Command: npx skills add https://github.com/celticht32/Couchbase-Skills-for-Claude.ai --skill couchbase-fts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you design and operate Couchbase Full Text Search and vector search so you can find the right documents by relevance, similarity, location, or faceted filters instead of relying on brittle exact-match queries.

Core Features & Use Cases

  • FTS Index Design: Define static or dynamic mappings, analyzers, field types, and doc_config settings for reliable search indexes.
  • Search Query Authoring: Use match, phrase, fuzzy, wildcard, regex, geo, boosting, highlighting, and facets to express richer retrieval logic.
  • Vector and Hybrid Search: Create and tune embedding-based kNN search and combine lexical and semantic ranking for AI applications.
  • Troubleshooting and Tuning: Diagnose missing results, stale indexes, slow queries, analyzer mismatches, and memory pressure.
  • Use Case: If you need product search, document relevance ranking, geo-proximity lookup, or semantic retrieval over embeddings, this Skill gives you the patterns and guardrails to implement it correctly.

Quick Start

Ask for help designing or debugging a Couchbase FTS or vector search index for your specific fields, analyzers, and query requirements.

Frequently Asked Questions about couchbase-fts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a Couchbase FTS index with correct field mappings and analyzers?

Designing a Couchbase FTS index requires defining static or dynamic mappings, selecting appropriate analyzers, configuring field types, and setting doc_config parameters to ensure reliable full text search behavior across your documents.

Can I combine lexical full text search and vector search in Couchbase?

Yes, you can perform hybrid search in Couchbase by combining lexical full text search queries with vector embedding-based kNN search to merge text relevance ranking and semantic similarity for AI retrieval workflows.

What's the best way to troubleshoot missing results in Couchbase full text search?

Troubleshooting missing results in Couchbase full text search involves diagnosing analyzer mismatches, verifying field mappings, checking for stale indexes, and evaluating query selection logic to ensure documents are correctly indexed and matched.

Does Couchbase full text search support geo search and faceted filtering?

Yes, Couchbase full text search supports geo proximity search queries and faceted filters, allowing you to find documents by location and aggregate search results into categorized buckets for richer retrieval logic.

Why does my Couchbase vector search return unreliable semantic similarity results?

Unreliable semantic similarity in Couchbase vector search often stems from incorrect vector dimensions, improper field mappings for embeddings, or suboptimal kNN query configurations that require tuning for accurate hybrid retrieval workflows.

How do I configure fuzzy matching and phrase queries in Couchbase FTS?

Configuring fuzzy matching and phrase queries in Couchbase FTS involves authoring search queries with specific match, phrase, and fuzzy operators to express richer text retrieval logic and handle approximate term variations.