--- title: "dbt Documentation Maintenance: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/dbt-labs-maintaining-dbt-documentation/ description: "Audits descriptions in a dbt manifest and drafts missing model or column documentation in the project’s existing style." --- # dbt Documentation Maintenance: review, setup & limitations · Undominated.ai > Audits descriptions in a dbt manifest and drafts missing model or column documentation in the project’s existing style. [← Explore all skills](/skills/) DATABASES / dbt Labs # dbt Documentation Maintenance Audits descriptions in a dbt manifest and drafts missing model or column documentation in the project’s existing style. See setup guidance ↓Original source ↗ SOURCE REVIEW Reviewed 2026-09-21 Evidence 8 linked sources Publisher dbt Labs Licence Apache-2.0 ↗ Revision a8607fc02a67 Read what was—and wasn’t—checked ↓ “Audits dbt documentation coverage and drafts missing model/column descriptions in the project's own house style, one folder at a time, for human review. Use” dbt Labs · upstream description ↗ Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Uses dbt’s resolved manifest rather than guessing YAML layout, and clearly limits column coverage to columns declared in that manifest. - Requires tracing grain and column meaning through SQL, refs and sources before writing descriptions, then leaves a scoped diff for human review. ### A good fit for - Backfilling documentation one dbt folder at a time - Finding declared models or columns without descriptions after a change ### Weigh up before choosing - The audit measures nonempty descriptions, not their correctness or every physical warehouse column; imported model nodes can also appear in a manifest. - Folder matching uses each model’s immediate directory, not recursive descendants, and suffixes can select similarly named folders. Inspect the printed scope before editing. - The suggested path-scoped git diff omits untracked schema files and changes elsewhere. Review git status plus every new or modified YAML file before accepting the handback. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - skills/dbt/skills/maintaining-dbt-documentation/SKILL.md - skills/dbt/skills/maintaining-dbt-documentation/audit_coverage.py - skills/dbt/skills/using-dbt-for-analytics-engineering/references/writing-documentation.md - README.md (installation, compatibility and licence sections) - LICENSE ### Our findings - The entire audit_coverage.py helper was inspected. It reads manifest JSON locally, groups model nodes by original_file_path and counts stripped nonempty descriptions. - The workflow refreshes the manifest, re-parses after changes, preserves existing correct descriptions and lists meanings it could not establish. - The helper itself performs no network calls or file writes; the surrounding dbt workflow can generate artifacts and optional warehouse inspection needs separate credentials. ### Not established by this review - The helper was not executed and no dbt project or warehouse was accessed. - No generated description was checked with a domain owner. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Add a skill to your workflow. Upstream setup instructions ↗ DOCUMENTED COMMAND npx skills add https://github.com/dbt-labs/dbt-agent-skills/tree/a8607fc02a679e81a2b0fe7fcb32a7568802e16a/skills/dbt/skills/maintaining-dbt-documentation Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - Install the complete directory, including audit_coverage.py. - Keep the working directory at the dbt project root and use the helper’s full installed path or its explicit manifest option. - The publisher’s running-dbt-commands and analytics-engineering skills provide optional companion guidance; install them if using those handoffs. - Run the folder audit for each intended directory; review new files and out-of-folder edits as well as tracked diffs. - Choose the intended host and project scope in the installer. The source revision is pinned; the installer itself is not executed or version-pinned by this review. ### Before you start - Node.js/npm and git for the documented Skills installer - A configured dbt project and its correct dbt executable - Python for the bundled audit helper; warehouse access only for optional physical-column inspection ### Compatibility Agent Skills-compatible coding agents · Claude Code ### dbt source and manifest files - Read model SQL, YAML, macros and generated manifest JSON - Write documentation and run dbt parse - Optional authorized warehouse reads to inspect columns not declared in the manifest ### Cost model Apache-licensed instructions and helper; agent calls and any optional dbt platform or warehouse compute are separate. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - Skill definition at reviewed revision ↗ Checked 2026-09-21 https://github.com/dbt-labs/dbt-agent-skills/blob/a8607fc02a679e81a2b0fe7fcb32a7568802e16a/skills/dbt/skills/maintaining-dbt-documentation/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access - Reviewed reference or helper: audit_coverage.py ↗ Checked 2026-09-21 https://github.com/dbt-labs/dbt-agent-skills/blob/a8607fc02a679e81a2b0fe7fcb32a7568802e16a/skills/dbt/skills/maintaining-dbt-documentation/audit_coverage.py Supports: review, limitations, install, access - Companion guidance for meaningful dbt descriptions ↗ Checked 2026-09-21 https://github.com/dbt-labs/dbt-agent-skills/blob/a8607fc02a679e81a2b0fe7fcb32a7568802e16a/skills/dbt/skills/using-dbt-for-analytics-engineering/references/writing-documentation.md Supports: whySelected, review, limitations - Publisher installation, compatibility and licensing guidance ↗ Checked 2026-09-21 https://github.com/dbt-labs/dbt-agent-skills/blob/a8607fc02a679e81a2b0fe7fcb32a7568802e16a/README.md Supports: install, compatibility, access, license - Upstream licence at reviewed revision ↗ Checked 2026-09-21 https://github.com/dbt-labs/dbt-agent-skills/blob/a8607fc02a679e81a2b0fe7fcb32a7568802e16a/LICENSE Supports: license, access.cost - Skills installer: source formats and repeated skill selection ↗ Checked 2026-09-21 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md Supports: install - Skills installer: full commit SHA checkout support ↗ Checked 2026-09-21 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts Supports: install - Skills installer: tree revision and subdirectory parsing ↗ Checked 2026-09-21 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/source-parser.ts Supports: install KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Supabase Postgres Best Practices ↗ Connects Postgres schema and query decisions to worked SQL examples, connection guidance and row-level security checks.](/skills/supabase-supabase-postgres-best-practices/)[### Anthropic Documentation Coauthoring ↗ Guides a human and agent through audience discovery, section-by-section drafting and a separate-reader review of a substantial document.](/skills/anthropics-doc-coauthoring/)[### Google Stitch Design-System Extraction ↗ Reads frontend source and theme files to draft a structured DESIGN.md for design-system documentation or later Stitch use.](/skills/google-labs-code-extract-design-md/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)