dbt-model-writer

Create, edit, and convert SQL into dbt models with config blocks and refs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jwest33/claude_code_plugin_dbt_snowflake_specialist --skill dbt-model-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbt-model-writer
Source: https://github.com/jwest33/claude_code_plugin_dbt_snowflake_specialist/tree/main/skills/dbt-model-writer
Command: npx skills add https://github.com/jwest33/claude_code_plugin_dbt_snowflake_specialist --skill dbt-model-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and refinement of dbt models, ensuring best practices, consistent structure, and maintainable transformations. It helps analytics engineers quickly generate staging, intermediate, and mart models with proper config blocks, documentation, and references.

Core Features & Use Cases

  • Model Creation: Generate new models with proper config blocks, materializations, and documentation.
  • Model Types: Staging (stg_.sql), Intermediate (int_.sql), and Mart (fct_/dim_.sql) patterns with ref() and source() usage.
  • Incremental & Docs: Supports incremental strategies, tests scaffolding, and schema documentation.

Quick Start

Use this Skill to generate a new dbt model file, for example stg_orders.sql, with a view configuration and a basic ref() to a source table, so you can start building the lineage.

Frequently Asked Questions about dbt-model-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate dbt model creation with proper configuration and documentation?

This Skill automates dbt model creation by generating staging, intermediate, and mart models with built-in config blocks, materializations, ref() and source() references, Jinja templating, and inline documentation—eliminating manual setup and enforcing best practices across your transformation layer.

Can I convert raw SQL into properly formatted dbt models?

Yes, this Skill converts raw SQL into dbt-compliant models by adding proper config blocks, CTE structure, source and ref() references, Jinja templating, and documentation scaffolding so your existing queries follow dbt standards without manual refactoring.

What's the best way to structure staging, intermediate, and mart models in dbt?

This Skill enforces dbt naming conventions and structure: staging models (stg_*.sql) with source() references, intermediate models (int_*.sql) with ref() logic, and mart models (fct_*/dim_*.sql) with complete documentation, config blocks, and materialization strategies for consistent lineage.

How do I generate schema documentation for dbt models automatically?

This Skill generates schema documentation alongside model creation by scaffolding test definitions and inline documentation blocks, ensuring your dbt project maintains comprehensive, maintainable documentation without manual effort.

Does this work with incremental dbt models?

Yes, this Skill supports incremental materialization strategies, allowing you to configure incremental logic, unique keys, and merge behavior directly within generated model config blocks for efficient data refresh patterns.

Can I update existing dbt models while maintaining their structure?

Yes, this Skill handles model editing by updating existing models while preserving structure, adding missing documentation, enforcing ref() and source() best practices, and refining Jinja logic without overwriting custom logic.