fetching-dbt-docs

Fetch dbt documentation pages as markdown from docs.getdbt.com URLs.

1|Updated Mar 25, 2025
One-click install
npx skills add https://github.com/ramtinJ95/dotfiles --skill fetching-dbt-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fetching-dbt-docs
Source: https://github.com/ramtinJ95/dotfiles/tree/main/arch-config/arch-dotfiles/agents/.agents/skills/fetching-dbt-docs
Command: npx skills add https://github.com/ramtinJ95/dotfiles --skill fetching-dbt-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies accessing dbt documentation by returning pages in clean markdown format, enabling AI-assisted answers without HTML clutter and with stable URLs.

Core Features & Use Cases

  • Markdown-first access: Resolve docs.getdbt.com pages to .md for AI-friendly consumption.
  • Flexible retrieval: Fetch single pages, page indexes, or the full docs for targeted research on dbt Cloud, dbt Core, and the dbt Semantic Layer.
  • Use Case: When you need quick, repeatable access to dbt documentation for feature lookups, troubleshooting, or onboarding a new team member.

Quick Start

Append .md to any dbt docs URL to fetch a markdown version, for example: https://docs.getdbt.com/docs/path/to/page.md

Frequently Asked Questions about fetching-dbt-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get dbt documentation in markdown format for AI consumption?

To get dbt documentation in markdown, append .md to any docs.getdbt.com URL. This resolves the page into a clean, machine-friendly format by stripping HTML clutter, making it ideal for AI-assisted answers.

Can I search dbt docs by keyword instead of fetching a single page?

Yes, you can search dbt docs by keyword. The tool supports flexible retrieval options including single page fetches, index page retrieval, and keyword searches across dbt Cloud, dbt Core, and the dbt Semantic Layer documentation.

What is the best way to retrieve dbt Core documentation without HTML clutter?

The best way to retrieve dbt Core documentation without HTML clutter is resolving docs.getdbt.com URLs to their .md counterparts. This returns clean markdown pages with stable URLs, enabling efficient feature lookups and troubleshooting.

Do I need any external dependencies or API keys to fetch dbt docs?

No external dependencies or API keys are needed to fetch dbt docs. The tool relies on standard CLI utilities like curl and awk, utilizing a lightweight cache to minimize repeated downloads and streamline access.

How does the lightweight cache minimize repeated downloads when accessing dbt docs?

The lightweight cache minimizes repeated downloads by storing previously fetched dbt documentation pages locally. This shell-scripting approach prevents redundant network requests when performing repeated keyword searches or indexing operations.

When should I use this approach over directly browsing the dbt docs website?

You should use this approach over direct browsing when you need repeatable, machine-friendly access to dbt documentation. It is specifically designed for onboarding, automated feature lookups, and AI-assisted troubleshooting without HTML interference.