Use when fetching dbt documentation, looking up dbt features, or answering questions about dbt Cloud, dbt Core, or the dbt Semantic Layer
View on GitHubFebruary 1, 2026
Select agents to install to:
npx add-skill https://github.com/dbt-labs/dbt-agent-skills/blob/main/skills/fetching-dbt-docs/SKILL.md -a claude-code --skill fetching-dbt-docsInstallation paths:
.claude/skills/fetching-dbt-docs/# 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.md ``` Always 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: ```bash ~/.claude/skills/fetch-dbt-docs/search-dbt-docs.sh <keyword> # Examples ~/.claude/skills/fetch-dbt-docs/search-dbt-docs.sh semantic_model ~/.claude/skills/fetch-dbt-docs/search-dbt-docs.sh "incremental strategy" ~/.claude/skills/fetch-dbt-docs/search-dbt-docs.sh metric dimension # OR search # Force fresh download (bypass 24h cache) ~/.claude/skills/fetch-dbt-docs/search-dbt-docs.sh metric --fresh ``` 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