dbt-labs/dbt-agent-skills

dbt‑Agent‑Skills – dbt를 위한 AI 기반 헬퍼

정의 – 대규모 언어 모델 에이전트(Claude, Cursor, OpenAI, Gemini 등)가 dbt 관련 작업을 자동으로 수행할 수 있게 하는 Agent Skills 라이브러리입니다. 각 스킬은 사용자의 자연어 요청이 목적과 일치할 때 에이전트가 로드할 수 있는 프롬프트, 스크립트, 메타데이터의 작은 번들입니다.

중요성 – dbt(데이터 빌드 도구)는 팀이 분석 파이프라인을 구축, 테스트, 문서화하는 사실상의 표준입니다. dbt 작업을 AI 에이전트 스킬로 노출함으로써 개발자는 LLM에게 "내 모델에 단위 테스트 추가해줘" 또는 *"dbt MCP 서버 구성해줘"*라고 요청할 수 있고, 에이전트는 적절한 dbt 명령을 실행하고 SQL을 생성하거나 파일을 편집합니다. 사용자가 저수준 CLI 구문을 작성할 필요가 없습니다.

주요 구성 요소

• 스킬 번들 – dbt(일상적인 분석 엔지니어링), dbt‑migration(일회성 업그레이드), dbt‑extras(예: Mermaid DAG 다이어그램).
• 설치 – Claude Code, Vercel Skills CLI, Tessl 또는 일반 dbt 패키지(dbt deps)를 통해. 저장소는 프로젝트의 packages.yml에 추가할 수 있는 세 개의 독립적인 dbt 패키지를 게시합니다.
• 지원 에이전트 – Agent Skills 사양을 구현하는 모든 AI 제품. Claude, Cursor, GitHub Copilot, Gemini, OpenAI, dbt Wizard CLI를 포함합니다.
• 스킬 카탈로그 – 예시:
  • using-dbt-for-analytics-engineering – 모델 구축/수정, 디버깅, 소스 탐색.
  • adding-dbt-unit-test – TDD 스타일 테스트 생성.
  • building-dbt-semantic-layer – MetricFlow 메트릭/차원 생성.
  • working-with-dbt-mesh – 계약, 버전, 프로젝트 간 참조 관리.
  • troubleshooting-dbt-job-errors – 플랫폼 오류 진단.
  • migrating-dbt-core-to-v2와 같은 마이그레이션 스킬.

작동 방식 – 스킬은 수동 슬래시 명령이 아닙니다. 설치 후 에이전트는 사용자의 프롬프트를 모니터링하고 일치 항목을 감지하면 관련 스킬을 자동으로 로드하여 정의된 워크플로(프롬프트 → 스크립트 → dbt CLI 호출 → 응답)를 실행합니다.

시작하기 – 마켓플레이스 항목(/plugin marketplace add dbt-labs/dbt-agent-skills)을 설치한 다음 원하는 스킬 세트(/plugin install dbt@dbt-agent-marketplace)를 설치합니다. Claude가 아닌 에이전트의 경우 Vercel CLI(npx skills add …) 또는 Tessl(tessl install …)을 사용합니다. 설치 후 dbt_project.yml에서 ai_provider를 설정하여 어떤 에이전트가 스킬을 로드해야 하는지 dbt에 알립니다.

대상 사용자 – 이미 dbt를 사용하고 CLI 명령을 입력하는 대신 LLM과 대화하여 일상 작업을 가속화하려는 데이터 분석가, 분석 엔지니어, 플랫폼 엔지니어.

라이선스 및 커뮤니티 – 저장소의 LICENSE에 따라 오픈소스입니다. 풀 리퀘스트를 통한 기여를 환영합니다. 프로젝트는 이슈 트래커, 토론 포럼, 스킬 변형 A/B 테스트를 위한 평가 하네스를 유지 관리합니다.