dbt-model-index

Provides a curated index of dbt models to guide BigQuery query writing.

823|66|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/warpdotdev/oz-skills --skill dbt-model-index
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbt-model-index
Source: https://github.com/warpdotdev/oz-skills/tree/main/.agents/skills/dbt-model-index
Command: npx skills add https://github.com/warpdotdev/oz-skills --skill dbt-model-index

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When writing SQL against a dbt-powered data warehouse, it is hard to know which BigQuery tables exist, what each one contains, and which model fits a vague data question. This Skill gives the agent a lookup index of dbt models so queries target the right tables with the right grain, filters, and join keys.

Core Features & Use Cases

  • Model Lookup Index: Organizes dbt models into domain sections (Users, Activity, Revenue, Events) with descriptions of each table's grain and content.
  • Query Guidance: Each entry lists "Useful for" bullets covering common query patterns, join keys, standard filters, and partition fields.
  • Cost and Correctness Guardrails: Documents mandatory filters (e.g., excluding internal users), partition pruning rules, and fully-qualified production table paths.
  • Use Case: A stakeholder asks "How many weekly active subscribers churned last quarter?" The agent consults the index to pick the activity and subscription models, applies the standard filters, and writes a partition-safe BigQuery query.

Quick Start

Ask the agent to find which dbt models answer your data question and write a BigQuery query using the indexed tables.

Frequently Asked Questions about dbt-model-index

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

FAQPage Schema
How do I find the right dbt model for a data question?

Consult the model index organized by domain sections such as Users, Activity, Revenue, and Events. Each entry describes the table's grain and lists "Useful for" bullets covering common query patterns, so you can match your question to the appropriate model.

How do I write BigQuery queries against a dbt data warehouse?

First identify the correct model from the index, then write SQL using the fully-qualified production path like your-gcp-project.prod.model_name. Apply documented standard filters and constrain the partition field and date range to avoid full-table scans.

How do I avoid accidental fan-outs when joining dbt models?

Check the documented grain of each model, which states what one row represents, before joining. The index notes key join keys per model so you can join on the canonical dimension without duplicating rows.

How do I customize this dbt model index for my project?

Organize your models into logical domain sections, then for each model add the table name, a one-to-two sentence description of its grain and content, and "Useful for" bullets. Also document standard filters, plan types, and any sensitive datasets.

Why should BigQuery queries filter on partition fields?

Large partitioned tables incur high scan costs when queried without partition filters. The index instructs always filtering on the partition field and constraining the date range to control costs and improve query performance.