dbt-bigquery

Generates, modifies, and validates dbt models and pipelines targeting Google BigQuery.

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Yashyasik/zexca-api --skill dbt-bigquery-yashyasik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dbt-bigquery
Source: https://github.com/Yashyasik/zexca-api/tree/main/.gemini/skills/dbt-bigquery
Command: npx skills add https://github.com/Yashyasik/zexca-api --skill dbt-bigquery-yashyasik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dbt-bigquery.

What problem does it solve? Building and maintaining dbt pipelines for BigQuery involves repetitive setup, SQL optimization, schema discovery, and error-prone configuration of profiles and projects. This Skill guides an AI agent through the entire dbt workflow so models are correct, optimized, and safely compiled before execution. ## Core Features & Use Cases - dbt Project Scaffolding: Initializes new dbt projects with dbt_project.yml, profiles.yml, and proper folder structure under a dedicated directory. - SQL Optimization & Data Cleaning: Automatically rewrites inefficient SQL patterns (e.g., IN subqueries to EXISTS) and applies data cleaning protocols to every pipeline. - Validation & Troubleshooting: Compiles models with dbt compile, runs tests, and diagnoses remote orchestration failures via Cloud Logging. - Use Case: Ask the agent to create a new dbt model that transforms raw events from a BigQuery source table into a cleaned, documented, unit-tested staging model with proper ref and source references. ## Quick Start Create a dbt model that aggregates daily revenue from my BigQuery orders table and compile the project to verify it works.

Frequently Asked Questions about dbt-bigquery

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

FAQPage Schema
How do I create a new dbt model for BigQuery?▼

Define a SQL file under the models directory with a config block specifying the materialization, reference upstream tables using ref or source functions, and add descriptions in YAML. Then run dbt compile to validate syntax and dependencies before executing.

How do I set up a dbt project with BigQuery?▼

Install the dbt-bigquery adapter in a Python virtual environment, then create dbt_project.yml and a matching profiles.yml with your GCP project, dataset, and location. Place the project in a dedicated subdirectory and verify with dbt compile.

Does dbt-bigquery support BigLake Iceberg tables with 4-part naming?▼

The dbt-bigquery adapter does not natively support 4-part Project.Catalog.Dataset.Table naming. A workaround concatenates catalog and dataset into the schema field of the source definition, though this conflicts with standard environment schema prefixing.

Why does my dbt pipeline fail with 'Could not find profile named X'?▼

This error occurs when profiles.yml is missing from the dbt project directory or remote orchestration bundle. Ensure profiles.yml exists alongside dbt_project.yml, matches the profile name in the project config, and maps correct BigQuery settings.

Can the agent run dbt models automatically after writing them?▼

No, dbt run is never executed without explicit user confirmation. The workflow only compiles and tests models to catch errors safely, leaving actual execution as a deliberate user decision to avoid unintended side effects.