Install agent skills

First-party agent skills for dbt-tools live under plugins/ in this repository. Host UIs package them as plugins; each plugin bundles a skills/ tree with the same eight primitive skill names.

Typical stack: CLI or MCP for artifact access; skills for workflow prompts in Cursor, Codex, or Claude Code.

See CLI vs MCP vs skills and the Skill catalog for handles and when to use each layer.

Plugin pair

Plugin id	Prerequisites	Runs via
dbt-tools-cli	dbt-tools on PATH (@dbt-tools/cli)	Shell / dbt-tools CLI commands
dbt-tools-mcp	Node.js 24.22.1+ and npx for @dbt-tools/mcp	MCP tools (dbt_tools_set_target, …)

Install both from the same repo marketplace when you want CLI skills and MCP tools with matching handles. MCP-only sessions still need dbt_tools_set_target per session (see dbt-tools-mcp README).

Prerequisites

• Node.js 24.22.1+ and dbt-tools on PATH (npm install -g @dbt-tools/cli or npx)
• dbt artifacts under target/ (overview)

Verify setup: dbt-tools status --dbt-target ./target

Cursor

Catalog: .cursor-plugin/marketplace.json.

1. Open this repository in Cursor (or add the GitHub repo as a remote marketplace).
2. Add marketplace → repository root (local folder) or https://github.com/yu-iskw/dbt-tools-ts.
3. Enable dbt-tools-cli and dbt-tools-mcp (project-scoped in this repo, or user-scoped everywhere).

Plugin manifests: plugins/dbt-tools-cli/.cursor-plugin/plugin.json, plugins/dbt-tools-mcp/.cursor-plugin/plugin.json.

Optional: MCP for Cursor to customize the bundled dbt-tools-mcp server beyond the plugin defaults.

Codex

Catalog: .agents/plugins/marketplace.json (marketplace name dbt-tools-ts).

From the repository root:

codex plugin marketplace add ./

Restart Codex, open the plugin directory, select marketplace dbt-tools-ts (local), and install dbt-tools-cli and dbt-tools-mcp.

See Codex plugin build docs.

Claude Code

Catalog: .claude-plugin/marketplace.json (marketplace name dbt-tools-ts).

From the repository root:

/plugin marketplace add .
/plugin install dbt-tools-cli@dbt-tools-ts
/plugin install dbt-tools-mcp@dbt-tools-ts

Also register via .claude/settings.json and plugins/dbt-tools-cli/.claude-plugin/plugin.json per Claude plugin marketplaces.

See Discover and install plugins.

Learn more

• Wire your coding agent
• Agents overview
• plugins README