discovery.yaml

# Skill discovery manifest
#
# Canonical source for first-turn routing. Each entry defines:
#   skill:          directory name under skills/
#   priority:       primary = wins ties — use for concept/foundational skills and
#                             narrow feature skills with unique triggers
#                   secondary = loses ties — use for language/feature-specific skills
#                             so a general question routes to the concept skill first
#   use_when:       single routing condition for the agent (one sentence)
#   triggers:       keyword/phrase list for cold-start routing
#
# Rules:
#   - No two skills may share the same trigger phrase (validator enforces this).
#   - Every skill in skills/ must have an entry here.
#   - priority: primary wins over secondary when multiple skills match the same phrase.
#   - Minimum 3 trigger phrases per skill.
#
# This file is the canonical source. Do NOT add triggers:, priority:, or
# use_when: to individual SKILL.md files — those fields are removed.
#
# Handoff edges live in routing.yaml. Run scripts/sync-handoffs.sh to keep
# SKILL.md handoff: blocks in sync with routing.yaml.

skills:

  # ── Router (Codex / implicit invocation entry point) ─────────────

  - skill: couchbase
    priority: primary
    use_when: the user asks any Couchbase question and no more specific skill has been loaded yet
    triggers:
      - "Couchbase"
      - "Couchbase SDK"
      - "Couchbase question"
      - "help with Couchbase"
      - "Couchbase help"

  # ── Getting Started ───────────────────────────────────────────────

  - skill: getting-started
    priority: primary
    use_when: a developer is new to Couchbase or asks how to get started
    triggers:
      - "new to Couchbase"
      - "getting started Couchbase"
      - "what is Couchbase"
      - "Couchbase vs MongoDB"
      - "Couchbase vs PostgreSQL"
      - "how does Couchbase work"
      - "Couchbase concepts"
      - "bucket scope collection"
      - "what is N1QL"
      - "what is SQL++"
      - "Couchbase overview"
      - "first steps Couchbase"
      - "learn Couchbase"
      - "Couchbase introduction"
  - skill: local-dev-setup
    priority: primary
    use_when: a developer wants to run Couchbase on their machine
    triggers:
      - "run Couchbase locally"
      - "Couchbase Docker"
      - "docker-compose Couchbase"
      - "local Couchbase setup"
      - "install Couchbase locally"
      - "Couchbase dev environment"
      - "init Couchbase cluster"
      - "Couchbase container"
      - "Couchbase on my laptop"
      - "start Couchbase locally"
  - skill: capella-quickstart
    priority: primary
    use_when: a developer is setting up Couchbase Capella for the first time
    triggers:
      - "Couchbase Capella"
      - "Capella free tier"
      - "Capella sign up"
      - "cloud.couchbase.com"
      - "Capella connection string"
      - "allowlist IP Capella"
      - "Capella database credentials"
      - "Capella quickstart"
      - "hosted Couchbase"
      - "Couchbase cloud free"
      - "try Couchbase cloud"
  - skill: vscode-extension
    priority: primary
    use_when: the user wants to use the Couchbase VS Code extension to browse data or run queries
    triggers:
      - "VS Code Couchbase"
      - "Couchbase extension"
      - "Couchbase plugin"
      - "vscode-couchbase"
      - "install Couchbase VS Code"
      - "Couchbase workbench VS Code"
      - "Couchbase MCP VS Code"
      - "Capella iQ VS Code"
      - "Couchbase IDE"
      - "browse Couchbase data"
  - skill: sqlpp-language
    priority: primary
    use_when: a developer needs to write or understand SQL++ queries regardless of SDK language
    triggers:
      - "SQL++ syntax"
      - "N1QL syntax"
      - "MISSING vs NULL"
      - "META().id"
      - "UNNEST Couchbase"
      - "ANY SATISFIES"
      - "ARRAY construct"
      - "JOIN Couchbase"
      - "NEST Couchbase"
      - "USE KEYS"
      - "window function SQL++"
      - "CTE SQL++"
      - "WITH clause SQL++"
      - "MERGE SQL++"
      - "SQL++ tutorial"
      - "how to query Couchbase"
      - "write a Couchbase query"
      - "query JSON Couchbase"
  - skill: error-handling
    priority: primary
    use_when: a developer encounters SDK errors or needs to implement error handling
    triggers:
      - "Couchbase error"
      - "TimeoutException Couchbase"
      - "AmbiguousTimeoutException"
      - "UnambiguousTimeoutException"
      - "DocumentNotFoundException"
      - "CasMismatchException"
      - "DurabilityImpossibleException"
      - "SDK error handling"
      - "Couchbase exception"
      - "sdk-doctor"
      - "Couchbase debug logging"
      - "connection error Couchbase"
      - "Couchbase retry"
      - "Couchbase SDK timeout"
      - "handle Couchbase errors"
  # ── Field-Level Encryption ────────────────────────────────────────

  - skill: fle
    priority: primary
    use_when: the user wants to encrypt specific document fields client-side before storing in Couchbase
    triggers:
      - "field level encryption Couchbase"
      - "FLE Couchbase"
      - "CryptoManager Couchbase"
      - "encrypt document field Couchbase"
      - "client side encryption Couchbase"
      - "encrypt PII Couchbase"
      - "couchbase-encryption"
      - "AeadAes256CbcHmacSha512"
      - "KeyProvider Couchbase"
      - "encrypt SSN Couchbase"
      - "encrypt credit card Couchbase"

  - skill: fle-python
    priority: secondary
    use_when: the user wants to use Field-Level Encryption with the Couchbase Python SDK
    triggers:
      - "FLE Python Couchbase"
      - "field level encryption Python"
      - "CryptoManager Python Couchbase"
      - "cbencryption Python"
      - "encrypt field Python Couchbase"

  - skill: fle-java
    priority: secondary
    use_when: the user wants to use Field-Level Encryption with the Couchbase Java SDK
    triggers:
      - "FLE Java Couchbase"
      - "field level encryption Java"
      - "CryptoManager Java Couchbase"
      - "@Encrypted Java Couchbase"
      - "encrypt field Java Couchbase"

  - skill: fle-go
    priority: secondary
    use_when: the user wants to use Field-Level Encryption with the Couchbase Go SDK
    triggers:
      - "FLE Go Couchbase"
      - "field level encryption Go"
      - "CryptoManager Go Couchbase"
      - "gocbencryption"
      - "encrypt field Go Couchbase"

  - skill: fle-dotnet
    priority: secondary
    use_when: the user wants to use Field-Level Encryption with the Couchbase .NET SDK
    triggers:
      - "FLE .NET Couchbase"
      - "FLE C# Couchbase"
      - "field level encryption .NET"
      - "CryptoManager .NET Couchbase"
      - "EncryptedField .NET"
      - "encrypt field .NET Couchbase"

  - skill: fle-nodejs
    priority: secondary
    use_when: the user wants to use Field-Level Encryption with the Couchbase Node.js SDK
    triggers:
      - "FLE Node.js Couchbase"
      - "field level encryption Node.js"
      - "CryptoManager Node.js Couchbase"
      - "couchbase-encryption npm"
      - "encrypt field Node.js Couchbase"

  - skill: fle-php
    priority: secondary
    use_when: the user wants to use Field-Level Encryption with the Couchbase PHP SDK
    triggers:
      - "FLE PHP Couchbase"
      - "field level encryption PHP"
      - "CryptoManager PHP Couchbase"
      - "encrypt field PHP Couchbase"

  - skill: fle-rust
    priority: secondary
    use_when: the user asks about Field-Level Encryption with the Couchbase Rust SDK
    triggers:
      - "FLE Rust Couchbase"
      - "field level encryption Rust"
      - "CryptoManager Rust Couchbase"
      - "encrypt field Rust Couchbase"

  - skill: fle-scala
    priority: secondary
    use_when: the user asks about Field-Level Encryption with the Couchbase Scala SDK
    triggers:
      - "FLE Scala Couchbase"
      - "field level encryption Scala"
      - "CryptoManager Scala Couchbase"
      - "encrypt field Scala Couchbase"

  - skill: fle-ruby
    priority: secondary
    use_when: the user asks about Field-Level Encryption with the Couchbase Ruby SDK
    triggers:
      - "FLE Ruby Couchbase"
      - "field level encryption Ruby"
      - "CryptoManager Ruby Couchbase"
      - "encrypt field Ruby Couchbase"

  # ── Testing Patterns ──────────────────────────────────────────────

  - skill: testing-patterns
    priority: primary
    use_when: the user wants to understand Couchbase testing strategy, test data management, or isolation concepts without a specific language
    triggers:
      - "unit test Couchbase"
      - "mock Couchbase collection"
      - "mock Couchbase cluster"
      - "integration test Couchbase"
      - "testcontainers Couchbase"
      - "test Couchbase application"
      - "test isolation Couchbase"
      - "test data Couchbase"
      - "mock collection Couchbase"
      - "Couchbase testing"
      - "test scope collection"
      - "flush bucket test"
  - skill: testing-patterns-python
    priority: secondary
    use_when: the user wants to test Python code that uses Couchbase — unit tests with mocks, integration tests with testcontainers, or test data isolation
    triggers:
      - "pytest Couchbase"
      - "unit test Couchbase Python"
      - "mock Couchbase Python"
      - "testcontainers Couchbase Python"
      - "integration test Couchbase Python"
      - "test isolation Couchbase Python"
  - skill: testing-patterns-java
    priority: secondary
    use_when: the user wants to test Java code that uses Couchbase — unit tests with Mockito, integration tests with testcontainers, or test data isolation
    triggers:
      - "JUnit Couchbase"
      - "unit test Couchbase Java"
      - "mock Couchbase Java"
      - "Mockito Couchbase"
      - "testcontainers Couchbase Java"
      - "integration test Couchbase Java"
      - "test isolation Couchbase Java"
  - skill: testing-patterns-go
    priority: secondary
    use_when: the user wants to test Go code that uses Couchbase — unit tests with interfaces, integration tests with testcontainers, or test data isolation
    triggers:
      - "unit test Couchbase Go"
      - "mock Couchbase Go"
      - "testcontainers Couchbase Go"
      - "integration test Couchbase Go"
      - "test isolation Couchbase Go"
  - skill: testing-patterns-dotnet
    priority: secondary
    use_when: the user wants to test .NET/C# code that uses Couchbase — unit tests with Moq, integration tests with testcontainers, or test data isolation
    triggers:
      - "unit test Couchbase dotnet"
      - "unit test Couchbase C#"
      - "mock Couchbase dotnet"
      - "Moq Couchbase"
      - "testcontainers Couchbase dotnet"
      - "integration test Couchbase dotnet"
      - "test isolation Couchbase dotnet"
  - skill: testing-patterns-nodejs
    priority: secondary
    use_when: the user wants to test Node.js code that uses Couchbase — unit tests with Jest, integration tests with testcontainers, or test data isolation
    triggers:
      - "Jest Couchbase"
      - "unit test Couchbase Node"
      - "mock Couchbase Node"
      - "testcontainers Couchbase Node"
      - "integration test Couchbase Node"
      - "test isolation Couchbase Node"
  - skill: testing-patterns-rust
    priority: secondary
    use_when: the user wants to test Rust code that uses Couchbase — unit tests with mockall, integration tests with testcontainers, or test data isolation
    triggers:
      - "unit test Couchbase Rust"
      - "mock Couchbase Rust"
      - "mockall Couchbase"
      - "testcontainers Couchbase Rust"
      - "integration test Couchbase Rust"
      - "test isolation Couchbase Rust"
  - skill: testing-patterns-scala
    priority: secondary
    use_when: the user wants to test Scala code that uses Couchbase — unit tests with ScalaMock, integration tests with testcontainers, or test data isolation
    triggers:
      - "unit test Couchbase Scala"
      - "mock Couchbase Scala"
      - "ScalaMock Couchbase"
      - "testcontainers Couchbase Scala"
      - "integration test Couchbase Scala"
      - "test isolation Couchbase Scala"
  - skill: testing-patterns-php
    priority: secondary
    use_when: the user wants to test PHP code that uses Couchbase — unit tests with PHPUnit, integration tests with testcontainers, or test data isolation
    triggers:
      - "unit test Couchbase PHP"
      - "mock Couchbase PHP"
      - "PHPUnit Couchbase"
      - "testcontainers Couchbase PHP"
      - "integration test Couchbase PHP"
      - "test isolation Couchbase PHP"
  - skill: testing-patterns-ruby
    priority: secondary
    use_when: the user wants to test Ruby code that uses Couchbase — unit tests with RSpec, integration tests with testcontainers, or test data isolation
    triggers:
      - "unit test Couchbase Ruby"
      - "mock Couchbase Ruby"
      - "RSpec Couchbase"
      - "testcontainers Couchbase Ruby"
      - "integration test Couchbase Ruby"
      - "test isolation Couchbase Ruby"
  - skill: caching-patterns
    priority: primary
    use_when: the user wants to use Couchbase as a cache, session store, or rate limiter
    triggers:
      - "Couchbase cache"
      - "TTL Couchbase"
      - "expiry Couchbase"
      - "cache-aside Couchbase"
      - "write-through Couchbase"
      - "session storage Couchbase"
      - "replace Redis Couchbase"
      - "Couchbase vs Redis"
      - "get_and_touch"
      - "getAndTouch"
      - "ephemeral bucket"
      - "rate limiting Couchbase"
      - "atomic counter Couchbase cache"
      - "Couchbase as cache"
      - "cache with Couchbase"
  # ── Couchbase Capella ─────────────────────────────────────────────

  - skill: capella
    priority: primary
    use_when: the user already has a Capella cluster and needs to connect an application, manage credentials, or provision infrastructure
    triggers:
      - "Capella"
      - "couchbases://"
      - "DBaaS"
      - "Capella Operational"
      - "managed Couchbase"
      - "Terraform Capella"
      - "Capella Terraform provider"
      - "couchbasecloud/capella"
      - "Capella IaC"
      - "provision Capella"
      - "Capella cluster connect"
      - "Capella SDK connection"
  - skill: app-services
    priority: primary
    use_when: the user is working with Capella App Services (managed Sync Gateway) — not self-hosted Sync Gateway
    triggers:
      - "Capella App Services"
      - "App Services"
      - "App Endpoint"
      - "App Services sync"
      - "Capella mobile sync"
      - "App Services user"
      - "App Services access control"
      - "App Services Management API"
      - "App Services Sync Function"
      - "couchbases:// App Services"
      - "App Services vs Sync Gateway"
      - "managed Sync Gateway"
      - "Capella mobile backend"
  # ── Couchbase Server ──────────────────────────────────────────────

  - skill: server-data-modeling
    priority: primary
    use_when: the user is designing a document schema or deciding how to structure data in Couchbase Server
    triggers:
      - "Couchbase data model"
      - "Couchbase schema"
      - "bucket design"
      - "scope design"
      - "collection design"
      - "embed vs reference"
      - "document structure"
      - "Couchbase multi-tenancy"
      - "Couchbase document pattern"
      - "Couchbase schema design"
      - "manual secondary index"
      - "KV lookup"
      - "lookup document"
      - "index document Couchbase"
      - "fast lookup Couchbase"
      - "design Couchbase documents"
      - "model data Couchbase"
  - skill: server-query-optimizer
    priority: primary
    use_when: the user has a slow SQL++ query or needs index recommendations
    triggers:
      - "CREATE INDEX"
      - "DROP INDEX"
      - "BUILD INDEX"
      - "ALTER INDEX"
      - "deferred build"
      - "index not online"
      - "GSI"
      - "primary scan"
      - "covering index"
      - "partial index"
      - "array index"
      - "INCLUDE MISSING"
      - "index replica"
      - "index partition"
      - "slow query Couchbase"
      - "query performance Couchbase"
      - "optimize Couchbase query"
      - "query taking too long"
      - "index recommendation Couchbase"
      - "Couchbase query slow"
      - "speed up Couchbase query"
      - "EXPLAIN Couchbase"
      - "query plan Couchbase"
      - "read query plan"
      - "EXPLAIN output"
      - "IndexScan cost"
  - skill: eventing
    priority: primary
    use_when: the user wants to trigger server-side logic when documents change
    triggers:
      - "Couchbase Eventing"
      - "Eventing Function"
      - "OnUpdate"
      - "OnDelete"
      - "document trigger"
      - "Couchbase event-driven"
      - "Eventing timer"
      - "Couchbase webhook"
      - "Couchbase data enrichment"
      - "Couchbase cascade delete"
      - "Eventing Service"
      - "couchbase.query Eventing"
      - "couchbase.analyticsQuery"
      - "inline N1QL Eventing"
      - "react to document changes"
      - "trigger on document update"
  - skill: security
    priority: primary
    use_when: the user needs to configure RBAC users, roles, or TLS for a Couchbase cluster
    triggers:
      - "Couchbase RBAC"
      - "Couchbase roles"
      - "Couchbase user"
      - "Couchbase permissions"
      - "least privilege Couchbase"
      - "Couchbase authentication"
      - "Couchbase authorization"
      - "data_reader"
      - "data_writer"
      - "query_select"
      - "Couchbase TLS"
      - "Couchbase certificate"
      - "Couchbase access denied"
      - "403 Couchbase"
      - "401 Couchbase"
      - "encryption at rest Couchbase"
      - "Couchbase encrypt data"
      - "Couchbase node encryption"
      - "Couchbase secret management"
      - "HIPAA Couchbase"
      - "PCI Couchbase"
      - "secure Couchbase"
      - "Couchbase audit log"
  - skill: xdcr
    priority: primary
    use_when: the user needs to replicate data between Couchbase clusters across datacenters
    triggers:
      - "XDCR"
      - "cross-datacenter replication"
      - "Couchbase replication"
      - "multi-region Couchbase"
      - "active-active Couchbase"
      - "XDCR filter"
      - "XDCR conflict"
      - "replicate between clusters"
      - "Couchbase geo-distribution"
      - "replicate Couchbase data"
      - "Couchbase geo replication"
      - "sync two Couchbase clusters"
      - "bidirectional replication Couchbase"
  - skill: cluster-ops
    priority: primary
    use_when: the user needs to add/remove nodes, configure failover, or plan cluster topology
    triggers:
      - "Couchbase cluster"
      - "Couchbase replicas"
      - "Couchbase failover"
      - "Couchbase rebalance"
      - "add node Couchbase"
      - "remove node Couchbase"
      - "Couchbase server groups"
      - "rack awareness Couchbase"
      - "Couchbase MDS"
      - "Multi-Dimensional Scaling"
      - "Couchbase node"
      - "Couchbase topology"
      - "Couchbase HA"
      - "Couchbase high availability"
      - "Couchbase node down"
      - "Couchbase cluster size"
      - "scale Couchbase"
      - "Couchbase node failure"
  - skill: kafka
    priority: primary
    use_when: the user wants to stream Couchbase data to or from Apache Kafka
    triggers:
      - "Couchbase Kafka"
      - "Kafka Connect Couchbase"
      - "DCP Couchbase"
      - "Couchbase streaming"
      - "Kafka source connector Couchbase"
      - "Kafka sink connector Couchbase"
      - "stream Couchbase to Kafka"
      - "Couchbase event stream"
      - "Couchbase change data capture"
      - "CDC Couchbase"
  - skill: migration
    priority: primary
    use_when: the user is migrating data or application code from another database to Couchbase
    triggers:
      - "migrate to Couchbase"
      - "import data"
      - "cbimport"
      - "cbexport"
      - "from MongoDB"
      - "from PostgreSQL"
      - "from MySQL"
      - "from DynamoDB"
      - "schema migration"
      - "bulk load"
      - "data import"
      - "move data to Couchbase"
      - "Couchbase data migration"
  - skill: backup
    priority: primary
    use_when: the user needs to back up, restore, or schedule backups of a Couchbase cluster
    triggers:
      - "cbbackupmgr"
      - "backup Couchbase"
      - "restore Couchbase"
      - "Couchbase backup strategy"
      - "backup archive"
      - "backup repository"
      - "incremental backup"
      - "full backup Couchbase"
      - "backup to S3"
      - "cbbackup"
      - "cbrestore"
      - "how to backup Couchbase"
      - "Couchbase data loss"
      - "restore Couchbase data"
      - "schedule Couchbase backup"
  - skill: disaster-recovery
    priority: primary
    use_when: the user is planning or executing a disaster recovery strategy for Couchbase
    triggers:
      - "Couchbase disaster recovery"
      - "RTO Couchbase"
      - "RPO Couchbase"
      - "Couchbase DR plan"
      - "Couchbase failover plan"
      - "active-passive Couchbase"
      - "regional failover Couchbase"
      - "Couchbase recovery plan"
      - "Couchbase DR runbook"
      - "Couchbase business continuity"
      - "Couchbase DR testing"
      - "recover Couchbase cluster"
      - "Couchbase region down"
  - skill: monitoring
    priority: primary
    use_when: the user needs to monitor cluster health, diagnose slow queries, or set up alerting
    triggers:
      - "Couchbase metrics"
      - "Prometheus Couchbase"
      - "cbstats"
      - "cbcollect_info"
      - "Couchbase Grafana"
      - "cluster health Couchbase"
      - "memory pressure Couchbase"
      - "Couchbase slow query log"
      - "Couchbase alert"
      - "Couchbase dashboard"
      - "system:completed_requests"
      - "resident ratio"
      - "ep_mem_high_wat"
      - "Couchbase monitoring"
      - "Couchbase health check"
      - "cluster not responding"
      - "Couchbase performance"
      - "memory usage Couchbase"
      - "Couchbase down"
  - skill: columnar-analytics
    priority: primary
    use_when: the user is running OLAP or analytical queries on Couchbase Server 8.x, or mentions Server 8, Couchbase 8, or the columnar engine
    triggers:
      - "columnar analytics"
      - "Couchbase columnar"
      - "Server 8 analytics"
      - "column store Couchbase"
      - "OLAP Couchbase 8"
      - "analytics service 8.x"
      - "columnar SQL++"
      - "Couchbase columnar endpoint"
      - "Couchbase 8 OLAP"
      - "columnar engine Couchbase"
      - "Couchbase 8 analytics"
      - "analytics Couchbase 8"
      - "Server 8.x analytics"
      - "native columnar"
      - "direct collection analytics"
      - "Capella Columnar"
      - "columnar DBaaS"
      - "Capella analytics cluster"
      - "managed columnar Couchbase"
  - skill: shell
    priority: primary
    use_when: the user wants to use cbsh (Couchbase Shell) for scripting, data import/export, or cluster management
    triggers:
      - "cbsh"
      - "Couchbase Shell"
      - "cb-env"
      - "doc get"
      - "doc upsert"
      - "doc import"
      - "query cbsh"
      - "cbsh script"
      - "cbsh pipeline"
      - "cbsh import"
      - "cbsh export"
      - "cbsh migrate"
      - "cbsh vector"
      - "cbsh RAG"
      - "cbsh clusters"
      - "cbsh Nushell"
      - "Couchbase CLI scripting"
  # ── Mobile — Android ──────────────────────────────────────────────

  - skill: mobile-android
    priority: primary
    use_when: building Android apps with Couchbase Lite
    triggers:
      - "Couchbase Lite Android"
      - "CBL Android"
      - "couchbase-lite-android"
      - "MutableDocument Android"
      - "Database Android Couchbase"
      - "QueryBuilder Android"
      - "Replicator Android"
      - "local database Android Couchbase"
      - "sync Android Couchbase"
      - "embedded database Android"
      - "offline Android Couchbase"
      - "Couchbase Lite"
      - "CBL"
      - "couchbase mobile"
  - skill: mobile-sync-android
    priority: primary
    use_when: the user is setting up bi-directional sync between Couchbase Lite and Sync Gateway on Android
    triggers:
      - "Couchbase Lite sync Android"
      - "Sync Gateway Android"
      - "Couchbase Mobile Android sync"
      - "offline-first Android"
      - "replication Android Kotlin"
      - "CBL sync Android"
      - "sync function Android"
      - "channels Android"
      - "Couchbase Lite replication Android"
      - "sync Couchbase Android app"
      - "Android Couchbase offline sync"
  - skill: mobile-conflict-resolution-android
    priority: primary
    use_when: implementing conflict resolution logic in Android apps that sync with Sync Gateway or Capella
    triggers:
      - "Couchbase Lite conflict Android"
      - "conflict resolution CBL Android"
      - "custom conflict resolver Android"
      - "merge conflict CBL Kotlin"
      - "auto-purge Android"
      - "conflict handler Android"
      - "resolve sync conflict Android"
      - "CBL conflict Kotlin"
  - skill: mobile-data-modeling
    priority: primary
    use_when: designing documents that will sync via Sync Gateway or Capella App Services
    triggers:
      - "Couchbase Mobile data model"
      - "Sync Gateway document design"
      - "channel design Couchbase"
      - "ownership field sync"
      - "type field Sync Gateway"
      - "embed vs reference mobile"
      - "document size Couchbase Lite"
      - "tombstone Couchbase"
      - "delta sync"
      - "multi-tenant sync"
      - "sync schema design"
      - "offline-first data model"
      - "design documents for sync"
      - "mobile document schema"
  - skill: mobile-logging-android
    priority: primary
    use_when: debugging Couchbase Lite Android/Kotlin issues or configuring production logging on Android
    triggers:
      - "Couchbase Lite logging Android"
      - "CBL log Android"
      - "LogSinks Android"
      - "file logging CBL Android"
      - "console logging CBL Kotlin"
      - "custom log sink Android"
      - "log level Couchbase Lite Android"
      - "cbl-log tool"
      - "debug replication Android"
      - "Couchbase Lite diagnostic Android"
      - "CBL debug Android"
  - skill: mobile-p2p-sync-android
    priority: primary
    use_when: syncing directly between Android devices without Sync Gateway
    triggers:
      - "Couchbase Lite P2P Android"
      - "peer-to-peer sync CBL Android"
      - "URLEndpointListener Android"
      - "device to device sync Android"
      - "CBL listener Android"
      - "passive peer Android"
      - "active peer Android Kotlin"
      - "P2P sync Android Couchbase"
      - "local network sync Android CBL"
  - skill: mobile-testing-android
    priority: primary
    use_when: writing unit or integration tests for Android apps that use Couchbase Lite
    triggers:
      - "test Couchbase Lite Android"
      - "unit test CBL Android"
      - "mock replicator Android"
      - "in-memory database CBL Android"
      - "JUnit Couchbase Lite"
      - "test isolation CBL Android"
      - "teardown CBL database Android"
      - "testing live query CBL Android"
      - "CBL test Android"
      - "Couchbase Lite unit test Kotlin"
  - skill: mobile-vector-search-android
    priority: primary
    use_when: implementing on-device AI search or semantic search in Android apps
    triggers:
      - "Couchbase Lite vector search Android"
      - "CBL vector search Kotlin"
      - "VectorIndexConfiguration Android"
      - "vector index Android"
      - "lazy vector index Android"
      - "semantic search Android"
      - "on-device RAG Android"
      - "on-device vector search Android"
      - "AI search Android Couchbase"
  # ── Mobile — iOS ──────────────────────────────────────────────────

  - skill: mobile-ios
    priority: primary
    use_when: building iOS or macOS apps with Couchbase Lite
    triggers:
      - "Couchbase Lite iOS"
      - "Couchbase Lite Swift"
      - "CBL iOS"
      - "CouchbaseLiteSwift"
      - "MutableDocument Swift"
      - "Database Swift Couchbase"
      - "QueryBuilder Swift"
      - "Replicator Swift"
      - "local database iOS Couchbase"
      - "sync iOS Couchbase"
      - "embedded database iOS"
      - "offline iOS Couchbase"
  - skill: mobile-sync-ios
    priority: primary
    use_when: the user is setting up bi-directional sync between Couchbase Lite and Sync Gateway on iOS
    triggers:
      - "Couchbase Lite sync iOS"
      - "Sync Gateway iOS"
      - "Couchbase Mobile iOS sync"
      - "offline-first iOS"
      - "replication iOS Swift"
      - "CBL sync iOS"
      - "sync function iOS"
      - "channels iOS"
      - "Couchbase Lite replication Swift"
      - "sync Couchbase iOS app"
      - "iOS Couchbase offline sync"
  - skill: mobile-conflict-resolution-ios
    priority: primary
    use_when: implementing conflict resolution logic in iOS/macOS apps that sync with Sync Gateway or Capella
    triggers:
      - "Couchbase Lite conflict iOS"
      - "conflict resolution CBL Swift"
      - "custom conflict resolver iOS"
      - "merge conflict CBL Swift"
      - "auto-purge iOS"
      - "conflict handler iOS"
      - "resolve sync conflict iOS"
      - "CBL conflict Swift"
  - skill: mobile-logging-ios
    priority: primary
    use_when: debugging Couchbase Lite iOS/macOS/Swift issues or configuring production logging on iOS
    triggers:
      - "Couchbase Lite logging iOS"
      - "CBL log Swift"
      - "LogSinks Swift"
      - "file logging CBL iOS"
      - "console logging CBL Swift"
      - "custom log sink iOS"
      - "log level Couchbase Lite iOS"
      - "debug replication iOS"
      - "Couchbase Lite diagnostic Swift"
      - "CBL debug iOS"
  - skill: mobile-p2p-sync-ios
    priority: primary
    use_when: syncing directly between Apple devices without Sync Gateway
    triggers:
      - "Couchbase Lite P2P iOS"
      - "peer-to-peer sync CBL Swift"
      - "URLEndpointListener iOS"
      - "device to device sync iOS"
      - "CBL listener iOS"
      - "passive peer iOS"
      - "active peer Swift"
      - "P2P sync iOS Couchbase"
      - "local network sync iOS CBL"
  - skill: mobile-testing-ios
    priority: primary
    use_when: writing unit or integration tests for iOS/macOS apps that use Couchbase Lite
    triggers:
      - "test Couchbase Lite iOS"
      - "unit test CBL Swift"
      - "mock replicator iOS"
      - "in-memory database CBL iOS"
      - "XCTest Couchbase Lite"
      - "test isolation CBL iOS"
      - "teardown CBL database iOS"
      - "testing live query CBL Swift"
      - "CBL test iOS"
      - "Couchbase Lite unit test Swift"
  - skill: mobile-vector-search-ios
    priority: primary
    use_when: implementing on-device AI search or semantic search in iOS/macOS apps
    triggers:
      - "Couchbase Lite vector search iOS"
      - "CBL vector search Swift"
      - "VectorIndexConfiguration iOS"
      - "vector index iOS"
      - "lazy vector index iOS"
      - "semantic search iOS"
      - "on-device RAG iOS"
      - "on-device vector search iOS"
      - "AI search iOS Couchbase"
  # ── SDK Connection (per language) ─────────────────────────────────

  - skill: server-connection-python
    priority: primary
    use_when: setting up a Couchbase SDK connection — defaults to Python; route to the matching language skill if the user specifies one
    triggers:
      - "connect to Couchbase"
      - "Couchbase connection string"
      - "Couchbase SDK setup"
      - "how to connect Couchbase"
      - "Couchbase client configuration"
      - "Couchbase Python connection"
      - "Python SDK connect"
      - "couchbase-python-client"
      - "acouchbase"
      - "ClusterOptions Python"
      - "PasswordAuthenticator"
      - "wait_until_ready Python"
      - "Couchbase Lambda Python"
      - "Couchbase timeout Python"
      - "ECONNREFUSED Couchbase Python"
      - "Couchbase connection pool"
      - "connection pooling Couchbase"
      - "connect to Capella"
      - "connect Python app to Capella"
      - "Capella Python SDK"
  - skill: server-connection-java
    priority: secondary
    use_when: instantiating or configuring a Java Couchbase client, troubleshooting connection errors, or building Java applications that connect to Couchbase
    triggers:
      - "Couchbase Java connection"
      - "Java SDK connect"
      - "java-client Couchbase"
      - "ClusterOptions Java"
      - "waitUntilReady Java"
      - "Couchbase Spring Boot"
      - "Couchbase timeout Java"
      - "UnambiguousTimeoutException Java"
  - skill: server-connection-go
    priority: secondary
    use_when: instantiating or configuring a Go Couchbase client, troubleshooting connection errors, or building Go services that connect to Couchbase
    triggers:
      - "Couchbase Go connection"
      - "gocb connect"
      - "gocb/v2"
      - "ClusterOptions Go"
      - "WaitUntilReady Go"
      - "Couchbase timeout Go"
      - "ErrUnambiguousTimeout Go"
  - skill: server-connection-dotnet
    priority: secondary
    use_when: instantiating or configuring a .NET Couchbase client, troubleshooting connection errors, or building C# applications that connect to Couchbase
    triggers:
      - "Couchbase .NET connection"
      - "Couchbase C# connect"
      - "CouchbaseNetClient"
      - "AddCouchbase"
      - "IClusterProvider"
      - "IBucketProvider"
      - "WaitUntilReadyAsync"
      - "Couchbase timeout .NET"
      - "UnambiguousTimeoutException .NET"
  - skill: server-connection-nodejs
    priority: secondary
    use_when: instantiating or configuring a Node.js Couchbase client, troubleshooting connection errors, or building Node.js serverless functions that connect to Couchbase
    triggers:
      - "Couchbase Node.js connection"
      - "couchbase npm connect"
      - "couchbase.connect Node.js"
      - "waitUntilReady Node.js"
      - "Couchbase Lambda Node.js"
      - "Couchbase timeout Node.js"
      - "UnambiguousTimeoutError Node.js"
  - skill: server-connection-rust
    priority: secondary
    use_when: instantiating or configuring a Rust Couchbase client, troubleshooting connection errors, or building Rust services that connect to Couchbase
    triggers:
      - "Couchbase Rust"
      - "couchbase crate"
      - "cargo add couchbase"
      - "Cluster::connect Rust"
      - "collection.upsert Rust"
      - "collection.get Rust"
      - "tokio Couchbase"
      - "async Couchbase Rust"
      - "wait_until_ready Rust"
      - "PasswordAuthenticator Rust"
      - "ClusterOptions Rust"
      - "transactions Rust Couchbase"
      - "ACID Rust Couchbase"
  - skill: server-connection-scala
    priority: secondary
    use_when: instantiating or configuring a Scala Couchbase client, troubleshooting connection errors, or building Scala applications that connect to Couchbase
    triggers:
      - "Couchbase Scala"
      - "scala-sdk Couchbase"
      - "Cluster.connect Scala"
      - "collection.upsert Scala"
      - "collection.get Scala"
      - "Try Couchbase Scala"
      - "JsonObject Scala Couchbase"
      - "ReplaceOptions Scala"
      - "Durability Scala Couchbase"
  - skill: server-connection-php
    priority: secondary
    use_when: instantiating or configuring a PHP Couchbase client, troubleshooting connection errors, or building PHP applications that connect to Couchbase
    triggers:
      - "Couchbase PHP"
      - "couchbase PHP extension"
      - "new Cluster PHP"
      - "collection->upsert PHP"
      - "collection->get PHP"
      - "ClusterOptions PHP"
      - "UpsertOptions PHP"
      - "Durability PHP Couchbase"
  - skill: server-connection-ruby
    priority: secondary
    use_when: instantiating or configuring a Ruby Couchbase client, troubleshooting connection errors, or building Ruby applications that connect to Couchbase
    triggers:
      - "Couchbase Ruby"
      - "couchbase gem"
      - "Cluster.connect Ruby"
      - "collection.upsert Ruby"
      - "collection.get Ruby"
      - "ClusterOptions Ruby"
      - "UpsertOptions Ruby"
      - "Durability Ruby Couchbase"
      - "transactions Ruby Couchbase"
      - "ACID Ruby Couchbase"
  # ── SQL++ Querying (per language) ─────────────────────────────────

  - skill: server-querying-python
    priority: secondary
    use_when: executing SQL++ queries from Python using cluster.query() or scope.query()
    triggers:
      - "SQL++ Python"
      - "N1QL Python"
      - "cluster.query Python"
      - "QueryOptions Python"
      - "QueryScanConsistency Python"
      - "named_parameters Python Couchbase"
      - "adhoc False Python"
      - "query_context Python"
  - skill: server-querying-java
    priority: secondary
    use_when: executing SQL++ queries from Java using cluster.query() or scope.query()
    triggers:
      - "SQL++ Java"
      - "N1QL Java"
      - "cluster.query Java"
      - "QueryOptions Java"
      - "QueryScanConsistency Java"
      - "namedParameters Java Couchbase"
      - "adhoc false Java"
      - "query_context Java"
  - skill: server-querying-go
    priority: secondary
    use_when: executing SQL++ queries from Go using cluster.Query() or scope.Query()
    triggers:
      - "SQL++ Go"
      - "N1QL Go"
      - "cluster.Query Go"
      - "QueryOptions Go"
      - "QueryScanConsistency Go"
      - "NamedParameters Go Couchbase"
      - "Adhoc false Go"
      - "query_context Go"
  - skill: server-querying-dotnet
    priority: secondary
    use_when: executing SQL++ queries from .NET using cluster.QueryAsync() or scope.QueryAsync()
    triggers:
      - "SQL++ .NET"
      - "N1QL C#"
      - "cluster.QueryAsync"
      - "QueryOptions .NET"
      - "QueryScanConsistency .NET"
      - "Parameter .NET Couchbase"
      - "Adhoc false .NET"
      - "query_context .NET"
  - skill: server-querying-nodejs
    priority: secondary
    use_when: executing SQL++ queries from Node.js using cluster.query() or scope.query()
    triggers:
      - "SQL++ Node.js"
      - "N1QL Node.js"
      - "cluster.query Node.js"
      - "QueryOptions Node.js"
      - "parameters Node.js Couchbase"
      - "adhoc false Node.js"
      - "queryContext Node.js"
  - skill: server-querying-rust
    priority: secondary
    use_when: executing SQL++ queries from Rust using cluster.query() or scope.query()
    triggers:
      - "SQL++ Rust"
      - "N1QL Rust"
      - "scope.query Rust"
      - "cluster.query Rust"
      - "QueryOptions Rust"
      - "ScanConsistency Rust"
      - "MutationState Rust"
      - "couchbase query Rust"
      - "SELECT Couchbase Rust"
      - "named parameter Rust Couchbase"
      - "positional parameter Rust Couchbase"
  - skill: server-querying-scala
    priority: secondary
    use_when: executing SQL++ queries from Scala using cluster.query() or scope.query()
    triggers:
      - "SQL++ Scala"
      - "N1QL Scala"
      - "cluster.query Scala"
      - "scope.query Scala"
      - "QueryOptions Scala"
      - "QueryParameters Scala"
      - "ScanConsistency Scala"
      - "rowsAs Scala Couchbase"
      - "case class Couchbase Scala"
      - "MutationState Scala"
  - skill: server-querying-php
    priority: secondary
    use_when: executing SQL++ queries from PHP using $cluster->query() or $scope->query()
    triggers:
      - "SQL++ PHP"
      - "N1QL PHP"
      - "cluster->query PHP"
      - "scope->query PHP"
      - "QueryOptions PHP"
      - "positionalParameters PHP"
      - "namedParameters PHP"
      - "QueryScanConsistency PHP"
      - "rows() PHP Couchbase"
  - skill: server-querying-ruby
    priority: secondary
    use_when: executing SQL++ queries from Ruby using cluster.query() or scope.query()
    triggers:
      - "SQL++ Ruby"
      - "N1QL Ruby"
      - "cluster.query Ruby"
      - "scope.query Ruby"
      - "QueryOptions Ruby"
      - "positional_parameters Ruby"
      - "named_parameters Ruby"
      - "scan_consistency Ruby Couchbase"
      - "rows Ruby Couchbase"
  # ── Transactions (per language) ────────────────────────────────────

  - skill: transactions-python
    priority: secondary
    use_when: implementing money transfers, inventory reservations, or any multi-document atomic operation in Python
    triggers:
      - "Couchbase transaction Python"
      - "cluster.transactions.run"
      - "TransactionFailed Python"
      - "TransactionExpired Python"
      - "ACID Python Couchbase"
      - "atomic update Python Couchbase"
      - "multi-document transaction Python"
      - "transaction Python Couchbase"
      - "rollback Python Couchbase"
  - skill: transactions-java
    priority: secondary
    use_when: implementing money transfers, inventory reservations, or any multi-document atomic operation in Java
    triggers:
      - "Couchbase transaction Java"
      - "cluster.transactions().run"
      - "TransactionFailed Java"
      - "ACID Java Couchbase"
      - "TransactionAttemptContext Java"
      - "atomic update Java Couchbase"
      - "multi-document transaction Java"
      - "transaction Java Couchbase"
      - "rollback Java Couchbase"
  - skill: transactions-go
    priority: secondary
    use_when: implementing money transfers, inventory reservations, or any multi-document atomic operation in Go
    triggers:
      - "Couchbase transaction Go"
      - "gocb Transactions Run"
      - "TransactionAttemptContext Go"
      - "ACID Go Couchbase"
      - "gocb transactions"
      - "atomic update Go Couchbase"
      - "multi-document transaction Go"
      - "transaction Go Couchbase"
      - "rollback Go Couchbase"
  - skill: transactions-dotnet
    priority: secondary
    use_when: implementing money transfers, inventory reservations, or any multi-document atomic operation in C#
    triggers:
      - "Couchbase transaction .NET"
      - "Couchbase transaction C#"
      - "cluster.Transactions().RunAsync"
      - "TransactionFailed .NET"
      - "ACID .NET Couchbase"
      - "atomic update .NET Couchbase"
      - "multi-document transaction C#"
      - "transaction dotnet Couchbase"
      - "rollback .NET Couchbase"
  - skill: transactions-nodejs
    priority: secondary
    use_when: implementing money transfers, inventory reservations, or any multi-document atomic operation in Node.js
    triggers:
      - "Couchbase transaction Node.js"
      - "transactions().run Node.js"
      - "TransactionFailed Node.js"
      - "ACID Node.js Couchbase"
      - "atomic update Node.js Couchbase"
      - "multi-document transaction JavaScript"
      - "transaction Node.js Couchbase"
      - "rollback Node.js Couchbase"
  - skill: transactions-scala
    priority: secondary
    use_when: implementing multi-document atomic operations in Scala
    triggers:
      - "transactions Scala Couchbase"
      - "ACID Scala Couchbase"
      - "cluster.transactions Scala"
      - "TransactionAttemptContext Scala"
      - "ctx.get Scala"
      - "ctx.replace Scala"
      - "ctx.insert Scala"
      - "TransactionFailed Scala"
      - "transaction rollback Scala"
  - skill: transactions-php
    priority: secondary
    use_when: implementing multi-document atomic operations in PHP
    triggers:
      - "transactions PHP Couchbase"
      - "ACID PHP Couchbase"
      - "cluster->transactions PHP"
      - "TransactionAttemptContext PHP"
      - "ctx->get PHP"
      - "ctx->replace PHP"
      - "ctx->insert PHP"
      - "TransactionFailedException PHP"
      - "transaction rollback PHP"
  - skill: transactions-ruby
    priority: secondary
    use_when: a Ruby developer asks about transactions (not supported — explain alternatives)
    triggers:
      - "Ruby SDK transactions not supported"
      - "atomic operations Ruby Couchbase"
      - "multi-document atomic Ruby"
      - "transaction rollback Ruby"
      - "Ruby Couchbase saga"
  - skill: transactions-rust
    priority: secondary
    use_when: a Rust developer asks about transactions (not supported — explain alternatives)
    triggers:
      - "Rust SDK transactions not supported"
      - "atomic operations Rust Couchbase"
      - "multi-document atomic Rust"
      - "transaction rollback Rust"
      - "Rust Couchbase saga"
  # ── Full-Text & Vector Search (concept) ─────────────────────────────

  - skill: search-concepts
    priority: primary
    use_when: a developer asks about FTS, vector search, hybrid search, RAG, or search index concepts
    triggers:
      - "vector search Couchbase"
      - "full-text search Couchbase"
      - "FTS Couchbase"
      - "semantic search Couchbase"
      - "Couchbase search index"
      - "create FTS index"
      - "create vector index"
      - "hybrid search Couchbase"
      - "Flex Index Couchbase"
      - "SEARCH() function"
      - "search concepts Couchbase"
      - "RAG Couchbase"
      - "retrieval augmented generation Couchbase"
      - "LangChain Couchbase"
      - "LlamaIndex Couchbase"
      - "embedding pipeline Couchbase"
      - "vector store Couchbase"
  # ── Full-Text & Vector Search (per language) ───────────────────────

  - skill: search-python
    priority: secondary
    use_when: running FTS or vector queries from Python using cluster.search() or scope.search()
    triggers:
      - "Couchbase search Python"
      - "FTS Python"
      - "MatchQuery Python"
      - "VectorSearch Python"
      - "GeoDistanceQuery Python"
      - "SearchOptions Python"
      - "cluster.search Python"
  - skill: search-java
    priority: secondary
    use_when: running FTS or vector queries from Java using cluster.searchQuery() or scope.searchQuery()
    triggers:
      - "Couchbase search Java"
      - "FTS Java"
      - "SearchQuery Java"
      - "VectorSearch Java"
      - "GeoDistanceQuery Java"
      - "SearchOptions Java"
      - "cluster.searchQuery Java"
  - skill: search-go
    priority: secondary
    use_when: running FTS or vector queries from Go using cluster.SearchQuery() or scope.SearchQuery()
    triggers:
      - "Couchbase search Go"
      - "FTS Go"
      - "SearchQuery Go"
      - "VectorSearch Go"
      - "GeoDistanceQuery Go"
      - "gocb SearchQuery"
      - "cluster.SearchQuery Go"
  - skill: search-dotnet
    priority: secondary
    use_when: running FTS or vector queries from .NET using cluster.SearchQueryAsync() or scope.SearchQueryAsync()
    triggers:
      - "Couchbase search .NET"
      - "FTS C#"
      - "MatchQuery .NET"
      - "VectorSearch .NET"
      - "GeoDistanceQuery .NET"
      - "SearchQueryAsync"
      - "SearchOptions .NET"
  - skill: search-nodejs
    priority: secondary
    use_when: running FTS or vector queries from Node.js using cluster.searchQuery() or scope.searchQuery()
    triggers:
      - "Couchbase search Node.js"
      - "FTS Node.js"
      - "SearchQuery Node.js"
      - "VectorSearch Node.js"
      - "GeoDistanceQuery Node.js"
      - "cluster.searchQuery Node.js"
  - skill: search-rust
    priority: secondary
    use_when: running FTS or vector queries from Rust using scope.search()
    triggers:
      - "Couchbase search Rust"
      - "FTS Rust"
      - "MatchQuery Rust"
      - "VectorSearch Rust"
      - "SearchRequest Rust"
      - "scope.search Rust"
      - "vector search Rust Couchbase"
      - "full-text search Rust Couchbase"
  - skill: search-scala
    priority: secondary
    use_when: running FTS or vector queries from Scala using cluster.searchQuery() or scope.searchQuery()
    triggers:
      - "Couchbase search Scala"
      - "FTS Scala"
      - "MatchQuery Scala"
      - "searchQuery Scala"
      - "VectorSearch Scala"
      - "SearchRequest Scala"
      - "vector search Scala Couchbase"
      - "full-text search Scala Couchbase"
  - skill: search-php
    priority: secondary
    use_when: running FTS or vector queries from PHP using $cluster->searchQuery()
    triggers:
      - "Couchbase search PHP"
      - "FTS PHP"
      - "MatchQuery PHP"
      - "SearchQuery PHP"
      - "VectorSearch PHP"
      - "cluster->search PHP"
      - "scope->search PHP"
      - "full-text search PHP Couchbase"
      - "vector search PHP Couchbase"
  - skill: search-ruby
    priority: secondary
    use_when: running FTS or vector queries from Ruby using cluster.search_query()
    triggers:
      - "Couchbase search Ruby"
      - "FTS Ruby"
      - "MatchQuery Ruby"
      - "cluster.search Ruby"
      - "scope.search Ruby"
      - "VectorSearch Ruby"
      - "full-text search Ruby Couchbase"
      - "vector search Ruby Couchbase"
  # ── SDK Patterns (per language) ────────────────────────────────────

  - skill: sdk-patterns-python
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, or sub-document patterns in Python
    triggers:
      - "CAS Python"
      - "optimistic locking Python"
      - "get_and_lock Python"
      - "bulk get Python"
      - "asyncio Couchbase Python"
      - "atomic counter Python"
      - "KV range scan Python"
      - "lookup_in Python"
      - "mutate_in Python"
      - "subdocument Python"
      - "array_append Python"
      - "exists Python Couchbase"
      - "get_any_replica Python"
      - "preserve_expiry Python"
      - "CasMismatchException Python"
      - "retry Couchbase Python"
  - skill: sdk-patterns-java
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, KV range scan, or sub-document patterns in Java
    triggers:
      - "CAS Java"
      - "optimistic locking Java"
      - "getAndLock Java"
      - "bulk get Java"
      - "Reactor Couchbase"
      - "Mono Flux Couchbase"
      - "reactive Java Couchbase"
      - "virtual threads Couchbase"
      - "atomic counter Java"
      - "lookupIn Java"
      - "mutateIn Java"
      - "subdocument Java"
      - "arrayAppend Java"
      - "exists Java Couchbase"
      - "getAnyReplica Java"
      - "preserve_expiry Java"
      - "CasMismatchException Java"
      - "retry Couchbase Java"
      - "KV range scan Java"
      - "PrefixScan Java"
      - "RangeScan Java Couchbase"
  - skill: sdk-patterns-go
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, or sub-document patterns in Go
    triggers:
      - "CAS Go"
      - "optimistic locking Go"
      - "GetAndLock Go"
      - "bulk get Go"
      - "goroutine Couchbase"
      - "collection.Do Couchbase"
      - "atomic counter Go"
      - "KV range scan Go"
      - "LookupIn Go"
      - "MutateIn Go"
      - "subdocument Go"
      - "ArrayAppend Go"
      - "exists Go Couchbase"
      - "GetAnyReplica Go"
      - "PreserveExpiry Go"
      - "ErrCasMismatch"
      - "retry Couchbase Go"
  - skill: sdk-patterns-dotnet
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, KV range scan, or sub-document patterns in .NET or C#
    triggers:
      - "CAS .NET"
      - "CAS C#"
      - "optimistic locking C#"
      - "GetAndLock .NET"
      - "bulk get .NET"
      - "Task.WhenAll Couchbase"
      - "async await Couchbase .NET"
      - "atomic counter .NET"
      - "LookupIn .NET"
      - "MutateIn .NET"
      - "subdocument .NET"
      - "ArrayAppend .NET"
      - "exists .NET Couchbase"
      - "GetAnyReplica .NET"
      - "PreserveExpiry .NET"
      - "CasMismatchException .NET"
      - "retry Couchbase .NET"
      - "KV range scan .NET"
      - "PrefixScan .NET"
      - "RangeScan .NET Couchbase"
  - skill: sdk-patterns-nodejs
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, KV range scan, or sub-document patterns in Node.js
    triggers:
      - "CAS Node.js"
      - "CAS JavaScript"
      - "optimistic locking Node.js"
      - "getAndLock Node.js"
      - "bulk get Node.js"
      - "Promise.all Couchbase"
      - "p-limit Couchbase"
      - "atomic counter Node.js"
      - "lookupIn Node.js"
      - "mutateIn Node.js"
      - "subdocument Node.js"
      - "arrayAppend Node.js"
      - "exists Node.js Couchbase"
      - "getAnyReplica Node.js"
      - "preserveExpiry Node.js"
      - "CasMismatchError Node.js"
      - "retry Couchbase Node.js"
      - "KV range scan Node.js"
      - "PrefixScan Node.js"
      - "RangeScan Node.js Couchbase"
  - skill: sdk-patterns-rust
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, or sub-document patterns in Rust
    triggers:
      - "CAS Rust Couchbase"
      - "optimistic locking Rust"
      - "CasMismatch Rust"
      - "bulk get Rust Couchbase"
      - "join_all Couchbase Rust"
      - "FuturesUnordered Couchbase"
      - "atomic counter Rust Couchbase"
      - "MutateInSpec Rust"
      - "LookupInSpec Rust"
      - "subdocument Rust Couchbase"
      - "array append Rust Couchbase"
      - "exists Rust Couchbase"
      - "get_any_replica Rust"
      - "preserve_expiry Rust"
      - "retry Couchbase Rust"
  - skill: sdk-patterns-scala
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, KV range scan, or sub-document patterns in Scala
    triggers:
      - "CAS Scala Couchbase"
      - "optimistic locking Scala"
      - "CasMismatchException Scala"
      - "getAndLock Scala"
      - "bulk get Scala Couchbase"
      - "Future Couchbase Scala"
      - "atomic counter Scala Couchbase"
      - "lookupIn Scala"
      - "mutateIn Scala"
      - "subdocument Scala Couchbase"
      - "array append Scala Couchbase"
      - "getAnyReplica Scala"
      - "preserve_expiry Scala"
      - "retry Couchbase Scala"
      - "KV range scan Scala"
      - "PrefixScan Scala"
      - "RangeScan Scala Couchbase"
  - skill: sdk-patterns-php
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, KV range scan, or sub-document patterns in PHP
    triggers:
      - "CAS PHP Couchbase"
      - "optimistic locking PHP"
      - "CasMismatchException PHP"
      - "getAndLock PHP"
      - "bulk get PHP Couchbase"
      - "atomic counter PHP Couchbase"
      - "lookupIn PHP"
      - "mutateIn PHP"
      - "subdocument PHP Couchbase"
      - "array append PHP Couchbase"
      - "getAnyReplica PHP"
      - "preserve_expiry PHP"
      - "retry Couchbase PHP"
      - "KV range scan PHP"
      - "PrefixScan PHP"
      - "RangeScan PHP Couchbase"
  - skill: sdk-patterns-ruby
    priority: secondary
    use_when: using CAS, bulk ops, atomic counters, KV range scan, or sub-document patterns in Ruby
    triggers:
      - "CAS Ruby Couchbase"
      - "optimistic locking Ruby"
      - "CasMismatch Ruby"
      - "get_and_lock Ruby"
      - "bulk get Ruby Couchbase"
      - "atomic counter Ruby Couchbase"
      - "lookup_in Ruby"
      - "mutate_in Ruby"
      - "subdocument Ruby Couchbase"
      - "array append Ruby Couchbase"
      - "get_any_replica Ruby"
      - "preserve_expiry Ruby"
      - "retry Couchbase Ruby"
      - "KV range scan Ruby"
      - "PrefixScan Ruby"
      - "RangeScan Ruby Couchbase"
  # ── Analytics (per language) ───────────────────────────────────────

  - skill: analytics-python
    priority: secondary
    use_when: writing Python Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics Python"
      - "CBAS Python"
      - "analytics_query Python"
      - "AnalyticsOptions Python"
      - "window function Couchbase Python"
      - "analytics Python Couchbase"
      - "Python OLAP Couchbase"
  - skill: analytics-java
    priority: secondary
    use_when: writing Java Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics Java"
      - "CBAS Java"
      - "analyticsQuery Java"
      - "AnalyticsOptions Java"
      - "AnalyticsResult Java"
      - "analytics Java Couchbase"
      - "Java OLAP Couchbase"
  - skill: analytics-go
    priority: secondary
    use_when: writing Go Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics Go"
      - "AnalyticsQuery Go"
      - "gocb AnalyticsQuery"
      - "AnalyticsOptions Go"
      - "analytics Go Couchbase"
      - "Go OLAP Couchbase"
  - skill: analytics-dotnet
    priority: secondary
    use_when: writing .NET Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics .NET"
      - "AnalyticsQueryAsync"
      - "AnalyticsOptions .NET"
      - "CBAS C#"
      - "analytics dotnet Couchbase"
      - "analytics C# Couchbase"
  - skill: analytics-nodejs
    priority: secondary
    use_when: writing Node.js Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics Node.js"
      - "analyticsQuery Node.js"
      - "analyticsQuery JavaScript"
      - "CBAS Node.js"
      - "analytics nodejs Couchbase"
      - "analytics JavaScript Couchbase"
  - skill: analytics-scala
    priority: secondary
    use_when: writing Scala Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics Scala"
      - "analyticsQuery Scala"
      - "CBAS Scala"
      - "Analytics Service Scala"
      - "analytics Scala Couchbase"
      - "OLAP Scala Couchbase"
      - "window function Scala Couchbase"
  - skill: analytics-ruby
    priority: secondary
    use_when: writing Ruby Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics Ruby"
      - "analytics_query Ruby"
      - "CBAS Ruby"
      - "Analytics Service Ruby"
      - "analytics Ruby Couchbase"
      - "OLAP Ruby Couchbase"
      - "window function Ruby Couchbase"
  - skill: analytics-php
    priority: secondary
    use_when: writing PHP Analytics queries on Couchbase Server 7.x (CBAS — not available on Server 8.x)
    triggers:
      - "Couchbase Analytics PHP"
      - "analyticsQuery PHP"
      - "CBAS PHP"
      - "Analytics Service PHP"
      - "analytics PHP Couchbase"
      - "OLAP PHP Couchbase"
      - "window function PHP Couchbase"
      - "PHP analytics query Couchbase"
  - skill: analytics-rust
    priority: secondary
    use_when: a Rust developer asks about the Analytics service (not supported — explain alternatives)
    triggers:
      - "Couchbase Analytics Rust"
      - "analytics_query Rust"
      - "CBAS Rust"
      - "Analytics Service Rust"
      - "analytics Rust Couchbase"
      - "OLAP Rust Couchbase"