bigquery-setup

Verify gcloud CLI, ADC tokens, and BigQuery dataset connectivity.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/al-stev/field-eng-skills --skill bigquery-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bigquery-setup
Source: https://github.com/al-stev/field-eng-skills/tree/main/.claude/skills/bigquery-setup
Command: npx skills add https://github.com/al-stev/field-eng-skills --skill bigquery-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gcloud, bq, and includes scripts (resource) components.

What problem does it solve?

Ensures developers and engineers can run analytics queries by validating Google Cloud Application Default Credentials and BigQuery connectivity, preventing permission and connectivity failures during data access.

Core Features & Use Cases

  • Environment Validation: Confirms gcloud CLI is installed and on PATH.
  • Credential Check: Verifies Application Default Credentials (ADC) token availability.
  • Project & Dataset Access: Tests connectivity to the wandb-production project and access to analytics and optional landing_development datasets.
  • Use Case: Useful for onboarding, troubleshooting local developer environments, CI pre-flight checks, and before running data analysis jobs that depend on BigQuery access.

Quick Start

Run the verification script to check gcloud installation, ADC token, BigQuery project access, and dataset availability by running bash .claude/skills/bigquery-setup/scripts/verify.sh

Frequently Asked Questions about bigquery-setup

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

FAQPage Schema
How do I verify BigQuery credentials and dataset access before running queries?

To verify BigQuery credentials, run the setup script to check gcloud CLI installation, Application Default Credentials token validity, and dataset availability for the wandb-production project.

What do I need to check Application Default Credentials for BigQuery on my machine?

Checking Application Default Credentials requires installing the gcloud CLI and bq command-line tool, then authenticating an account with explicit access to the wandb-production analytics dataset.

Why does my BigQuery connectivity test fail when troubleshooting local developer environments?

BigQuery connectivity tests fail when the gcloud CLI is missing from PATH, the ADC token is invalid, or the authenticated account lacks permissions for the target wandb-production datasets.

Can I use gcloud and bq to test BigQuery dataset access for specific projects?

Yes, you can use gcloud and bq to test BigQuery dataset access by validating project-level connectivity and checking availability of specific datasets like analytics.stg_salesforce_accounts and landing_development.

What's the best way to troubleshoot BigQuery permission failures during data access?

The best way to troubleshoot BigQuery permission failures is to run a verification script that sequentially validates gcloud installation, ADC token availability, and explicit dataset access permissions.