dbt-labs/dbt-agent-skills
A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively.
65
82%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Risky
Do not use without reviewing
SKILL.mdskills/fetching-dbt-docs/
- name:
- fetching-dbt-docs
- description:
- Use when fetching dbt documentation, looking up dbt features, or answering questions about dbt Cloud, dbt Core, or the dbt Semantic Layer
- user-invocable:
- No
- metadata:
- {"author":"dbt-labs"}
Fetch dbt Docs
Overview
dbt docs have LLM-friendly URLs. Always append .md to get clean markdown instead of HTML.
URL Pattern
| Browser URL | LLM-friendly URL |
|---|---|
https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens | https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens.md |
https://docs.getdbt.com/reference/commands/run | https://docs.getdbt.com/reference/commands/run.md |
Quick Reference
| Resource | URL | Use Case |
|---|---|---|
| Single page | Add .md to any docs URL | Fetch specific documentation |
| Page index | https://docs.getdbt.com/llms.txt | Find all available pages |
| Full docs | https://docs.getdbt.com/llms-full.txt | Search across all docs (filter by keyword first) |
Fetching a Single Page
WebFetch: https://docs.getdbt.com/docs/path/to/page.mdAlways add .md to the URL path.
Finding Pages
Step 1: Search the Index First
Use llms.txt to search page titles and descriptions:
WebFetch: https://docs.getdbt.com/llms.txt
Prompt: "Find pages related to [topic]. Return the URLs."This is fast and usually sufficient.
Step 2: Search Full Docs (Only if Needed)
If the index doesn't have results, use the script to search full page content:
The search script is located at scripts/search-dbt-docs.sh relative to this skill's base directory.
<SKILL_BASE_DIR>/scripts/search-dbt-docs.sh <keyword>
# Examples
<SKILL_BASE_DIR>/scripts/search-dbt-docs.sh semantic_model
<SKILL_BASE_DIR>/scripts/search-dbt-docs.sh "incremental strategy"
<SKILL_BASE_DIR>/scripts/search-dbt-docs.sh metric dimension # OR search
# Force fresh download (bypass 24h cache)
<SKILL_BASE_DIR>/scripts/search-dbt-docs.sh metric --freshImportant: Replace <SKILL_BASE_DIR> with the actual base directory path provided when this skill is loaded.
Then fetch individual pages with .md URLs.
Common Mistakes
| Mistake | Fix |
|---|---|
Fetching HTML URL without .md | Always append .md to docs URLs |
| Searching llms-full.txt first | Search llms.txt index first, only use full docs if no results |
| Loading llms-full.txt entirely | Use the search script to filter, then fetch individual pages |
| Guessing page paths | Use llms.txt index to find correct paths |
evals
skills
adding-dbt-unit-test
references
answering-natural-language-questions-with-dbt
building-dbt-semantic-layer
configuring-dbt-mcp-server
fetching-dbt-docs
scripts
migrating-dbt-core-to-fusion
running-dbt-commands
troubleshooting-dbt-job-errors
using-dbt-for-analytics-engineering