yu-iskw/dbt-tools-ts

refresh-snapshot

Reload in-memory artifacts after dbt run or a known artifact change. Use on the same target without restarting MCP.

bind-target

Establish the dbt artifact root for this session (local path, s3://, or gs://). Use before any other dbt-tools analysis primitive.

check-session

Check MCP session state—target, load time, stale flag, runs, warehouse type. Use as a gate before analysis primitives.

bind-target

Establish the dbt artifact root for this session (local path, s3://, or gs://). Use before any other dbt-tools analysis primitive.

check-session

Check whether dbt artifacts exist, are fresh, and which readiness level applies. Use as a gate before manifest- or run_results-based analysis.

describe-resource

Return metadata and context for one dbt resource by unique_id. Use when explaining what a model, source, or test does.

find-resources

Find dbt resources by name, type, tag, package, or path. Use to resolve unique_id before describe-resource, trace-dependencies, or query-executions.

query-executions

Filter and sort run_results node executions by status, time, and warehouse metrics. Use for post-run triage and slow-node investigation.

refresh-snapshot

Confirm artifacts are up to date after dbt run or a known artifact change. Use before re-running analysis on the same target.

summarize-run

Summarize a dbt run (status breakdown, bottlenecks, adapter totals) without listing every node execution. Use before drill-down with query-executions.

trace-dependencies

Trace upstream or downstream dependencies for a dbt resource. Use for lineage, build order, or downstream blast radius.

describe-resource

Return metadata for one dbt resource by uniqueId. Use when explaining what a model, source, or test does.

find-resources

Find dbt resources by name, type, tag, package, or path. Use to resolve uniqueId before describe-resource, trace-dependencies, or query-executions.

query-executions

Filter and sort node executions from run_results by status, time, and warehouse metrics. Use for post-run triage.

summarize-run

Summarize the loaded dbt run (status breakdown, bottlenecks, adapter totals) without per-node execution rows.

trace-dependencies

Trace upstream or downstream dependencies for a dbt resource. Use for lineage, build order, or downstream blast radius.

dbt-tools-cli-plugin-skill

Author a new agent skill under plugins/dbt-tools-cli/skills for @dbt-tools/cli; layout, plugin README index, and structural verification.

setup-dev-env

Set up the development environment for the project. Use when starting work on the project, when dependencies are out of sync, or to fix environment setup failures.

bump-workspace-versions

Bump synchronized semver versions across the root and @dbt-tools workspace package.json files. Use when asked to "bump package version", "release patch", "set all packages to X.Y.Z", "sync semver across workspace", or "prepare npm publish version bump".

build-and-fix

Build the project and automatically fix any build errors, compilation failures, or type mismatches. Use when the project fails to build, shows "broken" states, or after making significant changes.

check-directory-structure

Inspect repository layout with tree and find, compare to AGENTS.md conventions, and fix misplaced or overly flat generated files. Use when auditing folder structure, after scaffolding or bulk file generation, when output looks flat, or when asked where…

codeql-fix

Run CodeQL security/quality analysis and fix findings. Use when the user asks to run CodeQL, security scan, static analysis, or fix CodeQL findings.

dbt-tools-web-e2e-fix

Run Playwright E2E for @dbt-tools/web and fix failures. Use when the user asks to run E2E tests, fix E2E, fix Playwright failures, green test:e2e, or debug failing web app E2E—not unit tests (Vitest).

dbt-tools-web-e2e

Implement and extend deterministic Playwright E2E tests for @dbt-tools/web (packages/web). Use when adding or changing E2E specs, user-journey tests, analyze flow coverage, Playwright selectors, or fixtures aligned with the real UI—not autonomous browser LLM…

dbt-tools-web-pack-npx-smoke

Pack @dbt-tools/web to a tarball and smoke-test the published dbt-tools-web CLI via npx without npm publish. Use when verifying the npm distribution, pre-release checks, bin/dist-serve layout, or fixing pack/npx failures for the web package.

initialize-project

Initialize a new project from the TypeScript template by renaming packages, updating metadata, and cleaning up documentation. Use when starting a new project, "bootstrapping" from this template, or setting up a fresh repository.

test-and-fix

Run unit tests and automatically fix code failures, regression bugs, or test mismatches. Use when tests are failing, after implementing new features, or to repair "broken" tests.

ui-feature-verify

Lightweight verification for UI-only changes to @dbt-tools/web. Runs lint, unit tests, coverage, a fresh build, Playwright E2E, and a coverage gap report. Use instead of the full verifier when changes are confined to packages/web/src/ and/or…