Couchbase SQL++ tuning

A skill for diagnosing and fixing slow SQL++ / N1QL queries on Couchbase Server (7.x and 8.x). The mechanics of reading execution plans, choosing the right index type, fixing common anti-patterns, and wiring up the diagnostic tools.

Distinct from the sibling skills:

• couchbase-data-modeling — how to MODEL the data (document shape, boundaries, access patterns)
• couchbase-sizing — how to size the cluster
• couchbase-app-integration — how to write app code that uses Couchbase
• couchbase-migration-execution — how to move data INTO Couchbase
• couchbase-mcp — operating the cluster (the MCP server's cb_explain_query, cb_index_advisor, cb_perf_* tools)
• couchbase-sqlpp-tuning (this skill) — making queries that already exist run faster

If the conversation is "this query is slow, what do I do," this is the right skill.

When this skill applies