---
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 ↓](#setup)[Original source ↗](https://github.com/dbt-labs/dbt-agent-skills/tree/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 9 linked sources
 Publisher dbt Labs
 Licence [Apache-2.0 ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/LICENSE)
 Revision 77923f561356
 [Read what was—and wasn’t—checked ↓](#review)

“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. …”

 [dbt Labs · upstream description ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/SKILL.md) 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
- Skill directory (SKILL.md, audit_coverage.py), the companion writing-documentation.md and LICENSE compared with the previous review revision a8607fc0: byte-identical at 77923f56 (git blob SHAs). README.md adds a dbt-packages installation section.

### 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.
- Its frontmatter limits tools to Bash(dbt *), Bash(python3 *), Bash(git *), Read, Write, Edit, Glob and Grep, and sets user-invocable: false.

### 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.
- Not executed: it was not installed or run.

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 ↗](https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md)

DOCUMENTED COMMAND

 npx skills add dbt-labs/dbt-agent-skills/skills/dbt/skills/maintaining-dbt-documentation Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

 npx skills add https://github.com/dbt-labs/dbt-agent-skills/tree/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation Copy reviewed-revision command ↗ - 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.
- The README at this revision also documents installing the skills as dbt packages through packages.yml with revision: main and an ai_provider flag in dbt_project.yml; it advises pinning revision to a tag or commit SHA for reproducible installs.
- Choose your AI tools and project or global scope in the installer. The source revision shown here is the one reviewed; 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 ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/SKILL.md) Checked 2026-10-13 https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
- [Reviewed reference or helper: audit_coverage.py ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/audit_coverage.py) Checked 2026-10-13 https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/audit_coverage.py Supports: review, limitations, install, access
- [Companion guidance for meaningful dbt descriptions ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/using-dbt-for-analytics-engineering/references/writing-documentation.md) Checked 2026-10-13 https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/using-dbt-for-analytics-engineering/references/writing-documentation.md Supports: whySelected, review, limitations
- [Publisher installation, compatibility and licensing guidance ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/README.md) Checked 2026-10-13 https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/README.md Supports: install, compatibility, access, license
- [Upstream licence at reviewed revision ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/LICENSE) Checked 2026-10-13 https://github.com/dbt-labs/dbt-agent-skills/blob/77923f561356ab83ebd467c79c6805868346b33d/LICENSE Supports: license, access.cost
- [Skills installer: source formats and repeated skill selection ↗](https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md) Checked 2026-10-13 https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md Supports: install
- [Skills installer: full commit SHA checkout support ↗](https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/git.ts) Checked 2026-10-13 https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/git.ts Supports: install
- [Skills installer: tree revision and subdirectory parsing ↗](https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/source-parser.ts) Checked 2026-10-13 https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/source-parser.ts Supports: install
- [2026-10-15 C2-W11 source re-review at the existing pin ↗](https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/77923f561356ab83ebd467c79c6805868346b33d/skills/dbt/skills/maintaining-dbt-documentation/SKILL.md Supports: upstreamDescription, review.notTested, review.reviewedAt

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### CockroachDB SQL ↗ Cockroach Labs skill that turns a natural-language request into CockroachDB SQL, applies the relevant rule files with 00-fundamental-principles.md first, and tells the agent to run EXPLAIN on every generated query when a cluster connection is available.](/skills/cockroachlabs-cockroachdb-sql/)[### DuckDB read file ↗ DuckDB's read-file skill: one DuckDB CLI command that picks a reader by file extension and returns a file's schema, row count and first 20 rows, for local paths or HTTPS, S3, GCS and Azure URLs.](/skills/duckdb-read-file/)[### Postgres ↗ Timescale's postgres skill from pg-aiguide: a dispatcher that sends the agent to nine reference guides for schema exploration, table design, pgvector and hybrid search, TimescaleDB hypertables and schema migrations.](/skills/timescale-postgres/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
