dbt-runner

Invocation discipline and failure triage for running dbt against a warehouse. Half of all "dbt is broken" sessions are environment problems detectable before the first command, and most of the rest are misread output. This skill front-loads the former and catalogues the latter.

First action, every invocation

Check for .dbt-runner/context.md in the dbt project root.

• Absent → first run. Read references/install.md and run the bootstrap (discovers profile, target, engine, required env vars → writes the context file). Then continue.
• Present → load it; it is the source of truth for this project's dbt setup (profile, target, engine, required env-var names, project lore).

The context file holds names only, never secrets: no env-var values, no passphrases. It is committed to the project repo.