dbt-expert

Generates compliant YAML docs and maintains standards for dbt projects.

6|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/timequity/plugins --skill dbt-expert-timequity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbt-expert
Source: https://github.com/timequity/plugins/tree/main/craft-coder/data/dbt-expert
Command: npx skills add https://github.com/timequity/plugins --skill dbt-expert-timequity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

dbt best practices for organizing models, tests, and docs.

Core Features & Use Cases

  • Model Patterns: Staging, Intermediate, Mart
  • Testing: Schema tests with dbt
  • Documentation: YAML descriptions for models

Quick Start

Set up dbt project structure and run tests.

Frequently Asked Questions about dbt-expert

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

FAQPage Schema
How do I organize dbt models using staging, intermediate, and mart layers?

Organize dbt models into a layered architecture where staging models clean raw source data, intermediate models perform business logic transformations, and mart models serve final analytical tables. This structure enforces data lineage, improves maintainability, and enables consistent testing and documentation across your dbt project.

What's the best way to set up schema tests in dbt?

Define schema tests in YAML files alongside your dbt models to validate data quality—checking for unique values, non-null constraints, and referential integrity. Tests run during `dbt test` execution and catch data issues early, ensuring only validated data flows downstream.

How do I document dbt models and ensure consistency across my project?

Add semantic YAML descriptions directly in your model files and configure dbt_project.yml to enforce naming conventions and documentation standards. This creates discoverable, maintainable documentation that propagates to your dbt docs site and ensures all team members follow the same structure.

When should I use ref versus source in dbt models?

Use `source()` to reference raw tables in your data warehouse and `ref()` to reference other dbt models. This distinction establishes clear data lineage: sources mark entry points from external systems, and refs connect your transformation DAG, enabling dbt to understand dependencies and rebuild models correctly.

How do I configure macros and seeds in dbt for reproducible projects?

Define reusable SQL logic in macros and store static reference data in seed files (CSV format). Configure both in dbt_project.yml to ensure your entire project—transformations, tests, and static data—runs consistently across environments and team members.

Can I apply dbt best practices to source integration and data transformation workflows?

Yes. Best practices cover the full dbt workflow: standardized source definitions, layered model patterns, comprehensive schema and data tests, and semantic documentation. This approach scales from source ingestion through transformation to analytics-ready marts while maintaining data quality and project clarity.