dbt-labs avatar

Answering Natural Language Questions With Dbt

This turns natural language questions like "what were sales last quarter?" into actual answers by working through a priority waterfall: semantic layer first, then modifying compiled SQL if you need custom logic, then model discovery, then manifest parsing as a last resort. The systematic approach is the point here. It resists the temptation to immediately write ad-hoc SQL and instead exhausts what dbt already knows about your metrics and dimensions. When you're in a dbt project, it'll suggest semantic layer improvements rather than telling you to bug your data team. Built by dbt Labs, so the decision flow reflects how they think the semantic layer should actually be used in practice.

skills.sh installs
1.1K
GitHub stars
759
last updated
Aug 21, 2026

Install

$ npx -y skills add dbt-labs/dbt-agent-skills --skill answering-natural-language-questions-with-dbt --agent claude-code

Installs into .claude/skills of the current project.

Files

Answering Natural Language Questions with dbt

Overview

Answer data questions using the best available method: semantic layer first, then SQL modification, then model discovery, then manifest analysis. Always exhaust options before saying "cannot answer."

Use for: Business questions from users that need data answers

  • "What were total sales last month?"
  • "How many active customers do we have?"
  • "Show me revenue by region"

Not for:

  • Validating model logic during development
  • Testing dbt models or semantic layer definitions
  • Building or modifying dbt models
  • dbt run, dbt test, or dbt build workflows

Decision Flow

Sponsors

Details

Repository
github.com/dbt-labs/dbt-agent-skills
Categories
Testing & QA, AI & Agent Building, Data Science & ML, Marketing & SEO, Sales & Marketing, Databases
First seen
Jun 3, 2026

More from dbt-labs/dbt-agent-skills

All 13
1bobmatnyc avatardockerbobmatnyc/claude-mpm-skillsDocker containerization for packaging applications with dependencies into isolated, portable units ensuring consistency across development, testing, and product1.1Kskills.sh installs
2eronred avatarcustom-product-pageseronred/aso-skillsWhen the user wants to design, deploy, or measure Apple Custom Product Pages (CPP) — the alternate App Store product pages with different screenshots, preview v1.1Kskills.sh installs
3machina-sports avatarkalshimachina-sports/sports-skillsKalshi prediction markets — events, series, markets, trades, and candlestick data. Public API, no auth required for reads. US-regulated exchange (CFTC). Covers 1.1Kskills.sh installs
4postplusai avatarbenchmark-to-briefpostplusai/postplus-skillsTurn validated benchmark research into campaign briefs and concept candidates for short-form video production. Use this when you already have research artifacts1Kskills.sh installs
5kostja94 avatarpublic-relationskostja94/marketing-skillsWhen the user wants to plan PR, write a press release, or manage media relations. Also use when the user mentions "public relations," "PR," "press release," "me1Kskills.sh installs
6chrisbanes avatarcompose-recomposition-performancechrisbanes/skillsUse when investigating Jetpack Compose recomposition performance, skippable/restartable composables, composables.txt or compiler reports, Layout Inspector recom1Kskills.sh installs