Skip to content

feat: add altimate-dbt CLI and consolidate dbt skills into 5 focused skills#146

Closed
suryaiyer95 wants to merge 10000 commits intomainfrom
feat/dbt-skills-restructure
Closed

feat: add altimate-dbt CLI and consolidate dbt skills into 5 focused skills#146
suryaiyer95 wants to merge 10000 commits intomainfrom
feat/dbt-skills-restructure

Conversation

@suryaiyer95
Copy link
Copy Markdown
Contributor

@suryaiyer95 suryaiyer95 commented Mar 15, 2026

Summary

  • Adds altimate-dbt CLI package (packages/dbt-tools/) — a Bun TypeScript wrapper around @altimateai/dbt-integration for dbt project operations
  • Consolidates 8 scattered dbt skills into 5 focused skills with references/ directories for progressive context disclosure
  • All skills now use altimate-dbt commands instead of raw dbt

altimate-dbt CLI (packages/dbt-tools/)

New package providing 16 commands for dbt project operations:

Command Purpose
init Auto-detect dbt project, write config
doctor Validate project health
info Project metadata
compile / compile-query Jinja compilation
build / run / test / build-project Model execution
execute SQL execution against warehouse
columns / columns-source / column-values Column introspection
children / parents DAG navigation
deps / add-packages Package management

Architecture: one-shot CLI (run command → print JSON → exit). No MCP, no server, no API key required. Wraps @altimateai/dbt-integration via DBTProjectIntegrationAdapter.

dbt Skills Consolidation

New Skill Purpose References Replaces
dbt-develop Model creation hub 6 refs model-scaffold, yaml-config, medallion-patterns, incremental-logic, dbt-cli
dbt-test Schema + unit + custom tests 4 refs generate-tests
dbt-docs Model documentation 2 refs (enhanced)
dbt-troubleshoot Error diagnosis workflow 4 refs (new)
dbt-analyze Downstream impact analysis 2 refs impact-analysis

Deleted: dbt-cli, model-scaffold, generate-tests, yaml-config, incremental-logic, medallion-patterns, impact-analysis

Architecture: Lean SKILL.md for AI routing → deep references/ files loaded on-demand. Adopts patterns from dbt-labs/dbt-agent-skills: Iron Rules, Common Mistakes tables, explicit boundaries.

Test plan

  • bun packages/dbt-tools/src/index.ts prints usage
  • bun packages/dbt-tools/src/index.ts init detects dbt project
  • bun test --cwd packages/dbt-tools passes
  • Skills activate for correct prompt types
  • Deleted skills no longer appear in skill list
  • Spider2-DBT benchmark tasks for end-to-end validation

🤖 Generated with Claude Code

Loading
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.