skill

datavault4dbt-agent-skills

A curated collection of skills for AI agents to properly work with datavault4dbt.

ScalefreeCOM/datavault4dbt-agent-skillscommunitylistedunreviewednot running here yet

Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below; one-click install arrives with accounts.

README

synced Oct 14, 2026

datavault4dbt Agent Skills

A curated collection of Agent Skills for the datavault4dbt dbt package. These skills help AI agents build Data Vault 2 warehouses correctly — staging, hubs, links, satellites, and business-vault entities — across all adapters datavault4dbt supports.

Maintained by Scalefree.

What are Agent Skills?

Agent Skills are folders of instructions, examples, and resources that agents discover and load automatically. They are not slash commands: once installed, the agent loads the relevant skill when your prompt matches its use case. Just describe what you need in natural language.

What's included

Building Data Vault models with datavault4dbt: how to lay out a project and generate staging, hubs, links, satellites, and business-vault models using the package's macros and YAML-metadata pattern — with the right hash configuration, naming conventions, and materializations.

Installation

Claude Code (plugin install — recommended)

# Add the marketplace once
claude plugin marketplace add ScalefreeCOM/datavault4dbt-agent-skills

# Install the plugin
claude plugin install datavault4dbt@datavault4dbt-agent-skills

The plugin loads into every Claude Code session automatically. To update:

claude plugin update datavault4dbt@datavault4dbt-agent-skills

Claude Code (manual install — for offline or frozen snapshots)

Clone the repository and symlink the plugin directory into your skills folder:

git clone https://github.com/ScalefreeCOM/datavault4dbt-agent-skills.git
cd datavault4dbt-agent-skills

# User scope (available in every project)
mkdir -p ~/.claude/skills
ln -s "$PWD" ~/.claude/skills/datavault4dbt

Or load it for a single session:

claude --plugin-dir /path/to/datavault4dbt-agent-skills

git pull inside the clone keeps symlinked installs up to date.

Verify

Start a session in a dbt project and ask something like "add a customer hub with datavault4dbt" — the agent should load using-datavault4dbt on its own.

Other agents (Cursor, Cline, Copilot, …)

Any agent that supports the Agent Skills format works the same way: point its skills directory at the folders under skills/datavault4dbt/skills/. Check your client's docs for where that directory lives.

Available skills

Skill	Status	Description
`using-datavault4dbt`	✅ shipped	Build Data Vault models with datavault4dbt — project layout, choosing entities, and the YAML-metadata macro pattern. Entry point that routes to detailed references (staging, hubs/links, satellites, business vault, conventions).
`configuring-datavault4dbt`	✅ shipped	Install the package, copy global variables into `dbt_project.yml`, hash/naming settings, per-adapter setup.
`testing-a-datavault4dbt-project`	✅ shipped	Data Vault 2 technical tests — hashkey uniqueness/not-null, link→hub referential integrity, satellite key+load-date uniqueness.
`rehashing-datavault4dbt-entities`	✅ shipped	Recalculate hashkeys/hashdiffs after a hash-config change or v1→v2 upgrade, safely and in order.
`troubleshooting-datavault4dbt`	✅ shipped	Diagnose common failures — change-detection, high-water-mark, ghost-record, and YAML-metadata issues.
`building-business-vault-with-datavault4dbt`	🛠 planned (under consideration)	Standalone PIT / snapshot-control skill, if PIT work proves common (currently a `using-datavault4dbt` reference).

Prerequisites

Most skills assume:

dbt is installed and a project with dbt_project.yml exists.
The datavault4dbt package is (or will be) installed via packages.yml.
Basic familiarity with dbt (models, sources, packages) and Data Vault 2 concepts.

Compatible agents

These skills work with any AI agent that supports the Agent Skills format (Claude Code, Cursor, and others).