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).

datavault4dbt-agent-skills