Retrieves and searches dbt documentation pages in LLM-friendly markdown format. Use when fetching dbt documentation, looking up dbt features, or answering questions about dbt Cloud, dbt Core, or the dbt Semantic Layer.
85%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
The canonical home for this skill is dbt-labs/dbt-agent-skills
dbt docs have LLM-friendly URLs. Always append .md to get clean markdown instead of HTML.
| 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 |
| 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) |
WebFetch: https://docs.getdbt.com/docs/path/to/page.mdAlways add .md to the URL path.
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.
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.
| 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 |
dbt-labs/dbt-agent-skills
b8facde
Canonical home
since Feb 25, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.