northgraindata/dbt Doctor
Static analysis and health checks for dbt projects. Find missing docs, missing tests, schema drift risks, stale models, DAG maintainability issues, and CI quality gate failures.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 23, 2026
- License
- MIT
Pinned Snippet
uses: northgraindata/dbt-doctor@035374a2967c8fb2c50ec0ceb7e0fcb53aecdfb0 # dbt-doctor@0.3.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| directory | Project directory to scan | — | . |
| verbose | Show file details per rule | — | true |
| project | Workspace project(s) to scan (comma-separated) | no | — |
| diff | Base branch for diff mode (e.g. main). Only files changed vs this branch are scanned. | no | — |
| github-token | GitHub token for posting PR comments. When set on pull_request events, findings are posted as a PR comment. | no | — |
| fail-on | Exit non-zero when diagnostics fire (error, warning, none). | — | error |
| preset | Config preset: default, strict, enterprise (see .dbt-doctor). | no | — |
| score-mode | Score formula: files (default, penalizes affected-file ratio) or unique-rules. | no | — |
| offline | Use local score calculation only (skip dbt-doctor score API) | — | false |
| annotations | Emit diagnostics as GitHub Actions annotations | — | false |
| setup-sqlfluff | Install sqlfluff and sqlfluff-templater-dbt before scanning | — | true |
| node-version | Node.js version to use | — | 22 |
Outputs
| name | description |
|---|---|
| score | Health score (0-100) |