creating-mermaid-dbt-dag

Generate Mermaid diagrams of dbt model lineage with color-coded nodes.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/randoneering/nix-flake-mirror --skill creating-mermaid-dbt-dag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-mermaid-dbt-dag
Source: https://github.com/randoneering/nix-flake-mirror/tree/main/home/programs/opencode/skills/dbt/dbt-extras/skills/creating-mermaid-dbt-dag
Command: npx skills add https://github.com/randoneering/nix-flake-mirror --skill creating-mermaid-dbt-dag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Visualize dbt model lineage by generating Mermaid diagrams that you can drop into Markdown reports or docs.

Core Features & Use Cases

  • Generates Mermaid graphs from lineage data sourced by MCP tools (get_lineage_dev, get_lineage) or fallback parsing (manifest.json or code) to illustrate upstream and downstream relationships.
  • Helps teams communicate data flow, impact analysis, and documentation for dbt projects.
  • Use Case: Include a live lineage diagram in a project README to show dependencies between models, sources, and exposures.

Quick Start

Generate a Mermaid diagram for the selected dbt model and paste it into your Markdown document.

Frequently Asked Questions about creating-mermaid-dbt-dag

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

FAQPage Schema
How do I visualize dbt lineage as a Mermaid diagram?

You generate dbt lineage Mermaid diagrams by retrieving upstream and downstream model data via MCP tools or manifest.json parsing, producing a color-coded Markdown graph with a legend for documentation.

Can I generate Mermaid diagrams from a dbt manifest.json file?

Yes, you can generate Mermaid diagrams from a manifest.json file. When MCP tools like get_lineage_dev are unavailable, the Skill falls back to parsing manifest.json to map dependencies and render the data flow.

What is the best way to document dbt model dependencies in Markdown?

The best way to document dbt model dependencies in Markdown is generating Mermaid diagrams that color-code nodes by type, illustrating upstream and downstream relationships directly within your project README or reports.

Does dbt lineage visualization work without direct MCP server access?

Dbt lineage visualization works without direct MCP server access by falling back to parsing manifest.json or code, though the output includes notes on any limitations encountered during this fallback retrieval process.

What types of dbt nodes are included in the generated Mermaid graph?

The generated Mermaid graph includes all upstream and downstream dbt nodes such as models, sources, and exposures, applying proper color-coding and a legend according to node types to clarify data flow relationships.