A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively.
70
88%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Low
Low-risk findings worth noting
If a user tells you there is a problem with the project, review the target/run_results.json file to identify which resources failed and why.
Check the metadata.generated_at key to ensure the information is fresh.
import json
def review_dbt_run_results(run_results_path: str):
"""Review dbt run_results.json and identify failures."""
with open(run_results_path) as f:
data = json.load(f)
results = data.get('results', [])
failed = [r for r in results if r.get('status') == 'error']
print(f"Total: {len(results)} | Failed: {len(failed)}")
if failed:
print("\nFailed Resources:")
for r in failed:
# Extract resource name from unique_id (e.g., "model.project.name" -> "name")
resource_name = r['unique_id'].split('.')[-1]
resource_type = r['unique_id'].split('.')[0]
print(f"\n- {resource_type}: {resource_name}")
# Parse error message for key details
message = r.get('message', '')
if message:
# Extract the main error line
error_lines = [line for line in message.split('\n') if line.strip()]
print(f" Error: {error_lines[0] if error_lines else message}")
# Show compiled SQL if available
compiled = r.get('compiled_code', '').strip()
if compiled and len(compiled) < 200:
print(f" SQL: {compiled}")
elif compiled:
print(f" SQL: {compiled[:200]}...")
return failed
# Usage
failed_resources = review_dbt_run_results('target/run_results.json').changes
.claude
skills
auditing-skills
.claude-plugin
.cursor-plugin
.github
ISSUE_TEMPLATE
scripts
skills
dbt
.claude-plugin
.cursor-plugin
skills
adding-dbt-unit-test
references
answering-natural-language-questions-with-dbt
building-dbt-semantic-layer
configuring-dbt-mcp-server
fetching-dbt-docs
scripts
maintaining-dbt-documentation
running-dbt-commands
troubleshooting-dbt-job-errors
references
using-dbt-for-analytics-engineering
using-dbt-state
working-with-dbt-mesh
dbt-extras
.claude-plugin
skills
creating-mermaid-dbt-dag
dbt-migration
.claude-plugin
skills
migrating-dbt-core-to-v2
migrating-dbt-project-across-platforms
upgrading-dbt
references
scripts