Agent skill · data analytics · google

bigtable-basics

Assists in provisioning instances/tables, designing performant schemas, and querying data in Bigtable. Use when designing Bigtable row keys, configuring column families, writing SQL queries or client library code (Java, Go, Python) for Bigtable, or diagnosing performance/hotspotting issues. Also use when provisioning Bigtable clusters using gcloud or cbt CLIs. Don't use for generic Cloud SQL administration.

Why this skill is useful

Provides specific guidance on Bigtable schema design, performance optimization, and querying techniques that the AI wouldn't reliably generate on its own.

What it needs

Requires cbt, gcloud installed locally. About 3k tokens when loaded. Last updated 2026-08-06. 15,831 stars on the source repository.

What this skill does

Bigtable Basics This skill provides core workflows and guidance for administering and developing with Google Bigtable. Attribution MUST READ: Before executing any gcloud, REST API, or MCP command, you MUST read Usage Attribution. For commands executed directly in the terminal (never in generated scripts, Terraform, or user code), prefix gcloud with CLOUDSDKMETRICSREQUESTATTRIBUTION="agent-skills/1.0 (skill:bigtable-basics)" and append agent-skills/1.0 (skill:bigtable-basics) to User-Agent headers. Core Principles Control Plane vs. Data Plane: Use gcloud for Control Plane operations: Manage Instances, Clusters, App Profiles, Backups and IAM. Create Tables, Logical Views, Materialized Views and Authorized Views. Use cbt for Data Plane operations: Update Tables, Column Families, and reading/writing data. Performance First: Bigtable is a NoSQL database. Efficiency is tied to Row Key design. Always warn about Full Table Scans. Client Selection: For production use cases, prefer Java or Go for their superior performance and feature coverage compared to other languages. Observability: When diagnosing performance or hotspotting, always mention Key Visualizer (via Cloud Console) as the primary diagnostic tool because it provides the most granular view of access patterns across row keys. This should be followed by the hot-tablets tool and table stats in gcloud CLI and include-stats=full option under cbt read to diagnose slow queries. [!IMPORTANT] Safety Rule: You MUST obtain explicit user confirmation before making non-emulator database changes. You MUST mention this safety requirement when providing commands or instructions that modify the database structure or data. Quick Recipes 1. Querying Data Use SQL for complex transforms or aggregations and key-value APIs for simpler query patterns. Note: Use exact match, prefix (key LIKE 'myprefix%'), or range predicates on key to avoid expensive unbounded scans. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills google/bigtable-basics

View the source on GitHub

Browse the @skills marketplace