login
dbt-labs

fetching-dbt-docs

by @dbt-labs in DevOps & Cloud
3
0
# Install this skill:
npx skills add dbt-labs/dbt-agent-skills --skill "fetching-dbt-docs"

Install specific skill from multi-skill repository

# Description

Use when fetching dbt documentation, looking up dbt features, or answering questions about dbt Cloud, dbt Core, or the dbt Semantic Layer

# SKILL.md

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: false
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.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:

~/.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 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

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.