documenting-dbt-models

What problem does it solve?

This skill helps you document dbt models and columns in schema.yml so your team understands the dataset’s grain, business rules, and caveats—not just the technical structure.

Core Features & Use Cases

• Matches existing project documentation patterns by first inspecting existing schema.yml files and copying their style and depth.
• Turns model SQL into clear documentation by reading the relevant model SQL to identify grain and logic worth documenting.
• Improves discoverability for dbt docs by producing consistent model and column descriptions that support dbt docs generation and easier navigation.
• Use case: When you add a new model or update a business-critical metric, document the model and its key columns in schema.yml so analytics consumers trust how the data is defined and calculated.

Quick Start

Use the documenting-dbt-models skill to update models/marts/schema.yml by adding a model description and business-focused column definitions for a dbt model you are working on.