maintaining-dbt-documentation
Installation
SKILL.md
Maintaining dbt Documentation
Keep a dbt project's model and column documentation complete and consistent as it grows. This skill (1) audits which models lack YAML documentation, (2) drafts the missing descriptions in the conventions the project already uses — working one folder at a time — and (3) leaves every change for the user to review. It never commits or pushes.
Two ways it's used:
- Backfill — document a folder of undocumented models on a project that has drifted below full coverage.
- Keep in sync — after models are added or their SQL changes (common when many contributors are landing models), run the audit to find the gap, document just those, and re-verify.