К основному содержанию
скилл CX Codex

dbt-expert — скилл для Claude Code: что делает и как установить

Скилл dbt-expert для Claude Code помогает проектировать dbt-модели, тесты, документацию, макросы и Jinja-шаблоны. Решает задачи аналитической инженерии и SQL-преобразований.

Apache-2.0 180 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill dbt-expert -a claude-code
Открыть на GitHub

Что делает dbt-expert

dbt-expert подсказывает, как организовать dbt-проект со слоями staging, intermediate и marts, выбрать материализацию модели и связать модели через ref. Он помогает разбирать источники, промежуточные и витринные модели, инкрементальные загрузки, макросы и Jinja-шаблоны.

Скилл охватывает тесты первичных и внешних ключей, проверки уникальности и not_null, тесты бизнес-логики, freshness для источников и документацию моделей с описаниями колонок. Для работы с проектом он использует чтение, запись и редактирование файлов, поиск по ним и запуск команд оболочки. Без dbt-core версии 1.7.0 и выше скилл не рассчитан на эту конфигурацию.

Материалы по структуре проекта, источникам, инкрементальным моделям, тестам, макросам и снимкам подключаются из references/CORE_CONCEPTS.md по мере необходимости. Скилл также указывает на проблемы вроде сложных CTE, прямых ссылок на таблицы и моделей без тестов.

Какие задачи решает

  • организовать dbt-проект по слоям staging, intermediate и marts
  • настроить инкрементальную модель для больших таблиц фактов
  • добавить тесты первичных и внешних ключей
  • описать модели и колонки для документации dbt
  • заменить прямые ссылки на таблицы вызовами ref

Примеры запросов агенту

  • Разложи dbt-проект по слоям staging, intermediate и marts и предложи структуру моделей.
  • Проверь модели на тесты первичных ключей, внешних ключей, уникальности и not_null.
  • Настрой инкрементальную модель для событий и вынеси повторяющуюся логику в Jinja-макрос.

Как установить dbt-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill dbt-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/dbt-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/dbt-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о dbt-expert

Как установить dbt-expert в Claude Code?

Выполните npx skills add personamanagmentlayer/pcl --skill dbt-expert -a claude-code, затем проверьте файл ~/.claude/skills/dbt-expert/SKILL.md.

Что делает скилл dbt-expert?

Он помогает работать с dbt-моделями, источниками, тестами, документацией, инкрементальными моделями, макросами и Jinja. Также подсказывает, как избежать сложных CTE и прямых ссылок на таблицы.

Какая версия dbt нужна для dbt-expert?

Для скилла требуется dbt-core версии 1.7.0 или выше.

Исходный текст

SKILL.md · Apache-2.0
---
name: dbt-expert
version: 1.1.0
description: >-
  Expert-level dbt (data build tool), models, tests, documentation, incremental models,
  macros, and Jinja templating. Use when the user mentions analytics engineering, SQL, data
  transformation, Jinja, or testing, or when the task involves Project Structure and
  Configuration, Sources and Staging Models, Intermediate and Mart Models, or Incremental
  Models.
category: data
author: PCL Team
license: Apache-2.0
tags:
  - dbt
  - analytics-engineering
  - sql
  - data-transformation
  - jinja
  - testing
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
requirements:
  dbt-core: '>=1.7.0'
---

# dbt Expert

You are an expert in dbt (data build tool) with deep knowledge of data modeling, testing, documentation, incremental models, macros, Jinja templating, and analytics engineering best practices. You design maintainable, tested, and documented data transformation pipelines.

## Best Practices

### 1. Project Organization

- Follow medallion architecture: staging -> intermediate -> marts
- Use clear naming conventions (stg*, int*, fct*, dim*)
- Keep models focused and single-purpose
- Document all models and columns
- Use consistent column naming across models

### 2. Model Configuration

- Use appropriate materializations (view, table, incremental, ephemeral)
- Implement incremental models for large fact tables
- Add tests to all primary keys and foreign keys
- Use schemas to organize models by business domain
- Set appropriate freshness checks on sources

### 3. Performance

- Materialize large intermediate models as tables
- Use ephemeral for simple transformations
- Implement incremental loading for event data
- Create appropriate indexes in post-hooks
- Monitor model run times

### 4. Testing

- Test uniqueness and not_null on all primary keys
- Test relationships between fact and dimension tables
- Add custom tests for business logic
- Test data quality expectations
- Run tests in CI/CD pipeline

### 5. Documentation

- Document model purpose and grain
- Add column descriptions
- Include examples and usage notes
- Generate and publish documentation
- Keep documentation up to date

## Anti-Patterns

### 1. Complex CTEs

```sql
-- Bad: Many nested CTEs
with cte1 as (...), cte2 as (...), cte3 as (...)
-- 20 more CTEs
select * from cte23

-- Good: Break into intermediate models
select * from {{ ref('int_cleaned_data') }}
```

### 2. Not Using refs

```sql
-- Bad: Direct table reference
select * from analytics.staging.stg_orders

-- Good: Use ref
select * from {{ ref('stg_orders') }}
```

### 3. No Tests

```sql
-- Bad: No tests
-- Good: Always test PKs and FKs
columns:
  - name: id
    tests: [unique, not_null]
```

### 4. Hardcoded Values

```sql
-- Bad: Hardcoded date
where created_at >= '2024-01-01'

-- Good: Use variables
where created_at >= '{{ var("start_date") }}'
```

## Reference Documentation

Detailed material lives alongside this skill and is read on demand:

- [Core Expertise](references/CORE_CONCEPTS.md) — Project Structure and Configuration, Sources and Staging Models, Intermediate and Mart Models, Incremental Models, Tests, Macros, Snapshots (SCD Type 2), Documentation

## Resources

- [dbt Documentation](https://docs.getdbt.com/)
- [dbt Best Practices](https://docs.getdbt.com/guides/best-practices)
- [dbt Discourse Community](https://discourse.getdbt.com/)
- [dbt Package Hub](https://hub.getdbt.com/)
- [dbt Learn](https://learn.getdbt.com/)
- [Analytics Engineering Guide](https://www.getdbt.com/analytics-engineering/)
- [dbt Style Guide](https://github.com/dbt-labs/corp/blob/main/dbt_style_guide.md)

© PCL Team · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Данные и базы» →
dbt-data-transformation manutej Скилл dbt-data-transformation для Claude Code по dbt: модели, тесты, документация, инкрементальные сборки, макросы и пакеты. Наводит порядок в SQL-преобразованиях в хранилище. CX Codex +1 443установок running-dbt-commands dbt-labs Скилл running-dbt-commands для Claude Code, Codex, Cursor и других платформ, который форматирует и выполняет команды dbt CLI. Выбирает правильный исполняемый файл dbt и собирает параметры для build, run, test, show. CX Codex +1 1 100установок using-dbt-state dbt-labs Скилл using-dbt-state для Claude Code, который объясняет агенту, как работает dbt State — серверный механизм переиспользования узлов. Помогает включать, настраивать и отлаживать пропуск или клонирование моделей вместо полной перестройки. CX Codex +1 591установок analytics-engineer borghei Скилл analytics-engineer для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode помогает строить dbt-трансформации и размерные схемы. Запускается на задачах с SQL-моделями, тестами, инкрементальными таблицами фактов и метриками. CX Codex +1 207установок dbt Analytics Project taste f Промпт dbt Analytics Project taste для ChatGPT задаёт правила устройства dbt-проекта с моделями staging, intermediate и marts. Включается при проектировании моделей, тестов и CI для аналитики. GP ChatGPT ★ 178 201звёзд репо dbt-transformation-patterns Seth Hobson Скилл dbt-transformation-patterns для Claude, Codex и Cursor, который подсказывает агенту, как раскладывать dbt-модели по слоям, писать тесты и делать инкрементальные витрины. CX Codex +1 11 000установок

Из того же набора104

Весь набор →
media-expert Скилл media-expert для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который добавляет агенту экспертизу в медиапроизводстве, стриминге и вещании. CX Codex +1 182установок microservices-expert Скилл microservices-expert для Claude Code помогает проектировать микросервисную архитектуру, обмен между сервисами и распределённые операции. Разбирает задачи с service mesh и отказами. CX Codex +1 181установок api-design-expert Скилл api-design-expert для проектирования HTTP API: ресурсы REST, выбор между GraphQL и gRPC, схемы версионирования и единый формат ошибок. Полезен до того, как написан первый эндпоинт. CX Codex +1 180установок azure-expert Скилл azure-expert помогает проектировать архитектуру в Microsoft Azure, писать код для Azure Functions и Cosmos DB, а также генерировать команды Azure CLI. CX Codex +1 180установок rust-expert Скилл rust-expert для Claude Code задаёт ИИ-агенту роль Rust-разработчика: владение, лайфтаймы, async и обработка ошибок. Разбирает неочевидные ошибки borrow checker. CX Codex +1 179установок design-expert Скилл design-expert даёт агенту паттерны системного дизайна, масштабирования и распределённых систем с готовыми примерами кода на Python. CX Codex +1 178установок airflow-expert Скилл airflow-expert для Claude Code проектирует и разбирает Apache Airflow DAG, зависимости задач, операторы, сенсоры и расписания. Помогает работать с пайплайнами данных. CX Codex +1 174установок cloudflare-expert Скилл cloudflare-expert для Claude Code помогает с Workers, CDN, периферийными вычислениями и защитой Cloudflare. Активируется в задачах про WAF, сервисы Cloudflare и их инструменты разработки. CX Codex +1 174установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой