Skip to content

Repository files navigation

Data Engineering Skills

Claude Code skills for Analytics & Data engineers working with dbt and Snowflake

License: MITClaude Code

Altimate Data Skills is a collection of Claude Code skills that encode the workflows and best practices of experienced analytics engineers. These skills transform Claude from a code generator into a capable data engineering assistant.

Key Results

  • 53% accuracy on ADE-bench (43 real-world dbt tasks)
  • 3x improvement on model creation tasks vs baseline
  • 84% pass rate on Snowflake query optimization (62 TPC-H queries, 1TB dataset)
  • 3.6x better performance gains vs baseline (16.8% avg improvement vs 4.7%)
  • Skills that teach Claude how to work, not just what to write

Quick Start

/plugin marketplace add AltimateAI/data-engineering-skills

Install individual skill packs:

# Install dbt skills
/plugin install dbt-skills@data-engineering-skills
# Install Snowflake skills
/plugin install snowflake-skills@data-engineering-skills
# Install altimate-code delegation skill
/plugin install altimate-code@data-engineering-skills

Available Skills

dbt Skills

SkillPurposeKey Behaviors
creating-dbt-modelsModel creationConvention discovery → Write → Build → Verify output
debugging-dbt-errorsError troubleshootingRead full error → Check upstream → Apply fix → Rebuild
testing-dbt-modelsSchema testsStudy existing test patterns → Match project style
documenting-dbt-modelsDocumentationAnalyze model → Generate descriptions
migrating-sql-to-dbtLegacy SQL conversionParse SQL → Create proper dbt model
refactoring-dbt-modelsSafe restructuringTrack dependencies → Apply changes → Verify downstream
developing-incremental-modelsIncremental modelsStrategy selection → unique_key design → Handle edge cases

Snowflake Skills

SkillPurposeKey Behaviors
finding-expensive-queriesCost analysisFind and rank queries by cost/time/data scanned
optimizing-query-by-idPerformance tuningOptimize using query ID from history
optimizing-query-textPerformance tuningProfile query → Identify bottlenecks → Apply patterns

altimate-code Delegation

SkillPurposeKey Behaviors
altimate-codeHand off data tasks to altimate-codeVerify install → Invoke altimate-code run --yolo non-interactively → Read output file → Summarize for user

Use this skill when a task needs altimate-code's wired-up warehouse tools, column lineage, multi-step data exploration, or its 100+ specialized data tools.

Requires altimate-code:npm install -g altimate-code (Node 20+). Docs: docs.altimate.sh · Source: AltimateAI/altimate-code. The skill will detect a missing install and surface the exact command to the user.

How Skills Work

Skills are markdown files that teach Claude how to approach tasks, not just what syntax to use. Each skill has two parts:

1. Trigger Conditions

When should this skill activate?

---
name: creating-dbt-modelsdescription: | Guide for creating dbt models. ALWAYS use this skill when: (1) Creating ANY new model (staging, intermediate, mart) (2) Task mentions "create", "build", "add" with model/table (3) Modifying model logic or columns---

2. Workflow Instructions

What steps should Claude follow?

# dbt Model Development**Read before you write. Build after you write. Verify your output.**## Critical Rules1. ALWAYS run `dbt build` after creating models - compile is NOT enough
2. ALWAYS verify output after build using `dbt show`3. If build fails 3+ times, stop and reassess your approach
...

Usage Examples

Skills activate automatically based on your request:

Your RequestSkill Activated
"Create a new orders model"creating-dbt-models
"Fix this compilation error"debugging-dbt-errors
"Add tests to the customers model"testing-dbt-models
"Document the revenue metrics"documenting-dbt-models
"Create an incremental model for events"developing-incremental-models
"This query is slow, optimize it"optimizing-query-text

Combining with Altimate MCP Tools

Skills become even more powerful when combined with Altimate's MCP server. The MCP server provides real-time access to your dbt project and data warehouse:

MCP ToolWhat It Provides
dbt_project_infoProject structure, model list, sources
dbt_model_detailsColumn types, dependencies, compiled SQL
dbt_compileCompile models without CLI
snowflake_query_historyRecent query executions and stats
snowflake_table_statsRow counts, clustering info

Kits

Kits bundle skills, MCP servers, and instructions into a single activatable unit. Instead of installing skills one by one, activate a kit to get a complete development setup.

Available Kits

KitDescriptionSkillsMCP
dbt-snowflakeComplete dbt + Snowflake setup9 skillsdbt MCP server

Quick Start

# Install the kit
altimate-code kit install AltimateAI/data-engineering-skills
# Activate for your project
altimate-code kit activate dbt-snowflake
# Check what's active
altimate-code kit status

See kits/README.md for the full kit format reference and how to create your own.

Benchmark Results

Evaluated using ADE-bench, a framework for evaluating AI agents on analytics engineering tasks. All tests were run using Claude Sonnet 4.5.

Overall Results

ConfigurationAccuracyTasks Resolved
Baseline Claude (no skills)46.5%20/43
Claude + Skills53.5%23/43

Results by Task Category

CategoryBaselineWith SkillsImprovement
Model Creation40%65%+25 pts
Bug Fixing60%70%+10 pts
Debugging35%50%+15 pts
Refactoring30%35%+5 pts
Analysis25%30%+5 pts

Snowflake Query Optimization (TPC-H SF1000)

Benchmark on TPC-H 1TB dataset (62 queries) testing optimizing-query-text skill. All tests were run using Claude Sonnet 4.5.

ConfigurationPass RateAvg Performance Improvement
Baseline Claude (no skills)77.4% (48/62)4.7%
Claude + Skills83.9% (52/62)16.8% (3.6x better)

Skills provide structured optimization with query profiling, anti-pattern detection, and semantic preservation validation.

Note: This benchmark uses our internal evaluation framework. We plan to open-source it soon with additional evals.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Ideas for contributions:

  • New skills for workflows we haven't covered
  • Improvements to existing skills based on your team's patterns
  • Benchmark results on different datasets
  • Bug reports and feature requests

Roadmap

We're actively developing:

  • Airflow skills — DAG development, debugging, testing
  • Cross-platform migration — dbt to/from SQL Server, Oracle
  • Snowflake cost optimization — Warehouse sizing, query patterns
  • Data quality workflows — Anomaly detection, freshness checks

Resources

License

This project is licensed under the MIT License - see the LICENSE file for details.


Built by the team at Altimate AI — Making data engineering delightful.

About

Skills related to Data Engineering Work for Claude Code

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

122 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors