This is a comprehensive dbt implementation guide that covers the full stack: project structure, source definitions, staging layers, intermediate models, and mart tables. You get real YAML configs for multi-environment setups (dev, prod, Snowflake), proper source freshness checks, and the staging-intermediate-mart pattern that keeps transforms maintainable. The examples show practical patterns like ephemeral intermediates, surrogate key generation, and incremental models with merge strategies. If you're setting up a new dbt project or refactoring an existing one into proper layers, this gives you the scaffolding and conventions to start from. It assumes you know SQL but treats dbt's Jinja patterns and materialization strategies as learnable rather than obvious.

skills.sh installs
177
GitHub stars
44
last updated
Aug 21, 2026

Install

$ npx -y skills add personamanagmentlayer/pcl --skill dbt-expert --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/personamanagmentlayer/pcl
Categories
DevOps & CI/CD, Documentation
First seen
Jun 3, 2026

More from personamanagmentlayer/pcl

All 99
1aibtcdev avatarbusiness-devaibtcdev/skillsFull-cycle revenue engine — prospecting, CRM pipeline management, closing deals, partnerships, and engineering-as-marketing. External sales via GitHub and web.176skills.sh installs
2brooksy4503 avatarrss-agent-discoverybrooksy4503/rss-agent-discoveryAI agent-focused RSS feed discovery tool with JSON output. Use when Claude needs to discover RSS/Atom feeds from websites for monitoring, aggregation, or conten176skills.sh installs
3nikhilbhansali avatardataforseonikhilbhansali/dataforseo-skill-claudeComplete DataForSEO API integration for SEO data and analysis. Use when the user asks for keyword research, search volume, SERP analysis, backlink audits, compe176skills.sh installs
4samhvw8 avatarfrontend-developmentsamhvw8/dotfilesMulti-framework frontend development. Frameworks: React 18+ (Suspense, hooks, TanStack), Vue 3 (Composition API, Pinia, Nuxt), Svelte 5 (Runes, SvelteKit), Angu174skills.sh installs
5aiskillstore avatarinternal-commsaiskillstore/marketplaceA set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever 173skills.sh installs
6charleswiltgen avataraxiom-core-locationcharleswiltgen/axiomUse for Core Location implementation patterns - authorization strategy, monitoring strategy, accuracy selection, background location173skills.sh installs