dataform-engineering-fundamentals

Enforce BigQuery Dataform development practices with TDD, safety checks, and ${ref()} dependencies.

1|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/ihistand/claude-skills --skill dataform-engineering-fundamentals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dataform-engineering-fundamentals
Source: https://github.com/ihistand/claude-skills/tree/main/dataform-engineering-fundamentals
Command: npx skills add https://github.com/ihistand/claude-skills --skill dataform-engineering-fundamentals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents common Dataform development pitfalls, ensuring robust, maintainable, and safe data transformation pipelines, even under pressure.

Core Features & Use Cases

  • TDD Enforcement: Guarantees tests are written before implementation for Dataform SQLX files.
  • Safety Practices: Mandates --schema-suffix dev and --dry-run for all development.
  • Dependency Management: Enforces the use of ${ref()} over hardcoded table paths.
  • Documentation Standards: Requires comprehensive columns: {} documentation for all tables.
  • Architecture Patterns: Promotes layered structures and proper use of incremental vs. full refresh.
  • Use Case: When tasked with creating a new data mart table under a tight deadline, this Skill ensures you write assertions first, use safe development commands, and document columns properly, preventing costly production errors and technical debt.

Quick Start

Use the dataform-engineering-fundamentals skill to develop BigQuery Dataform transformations, ensuring TDD, safety practices, and proper documentation.

Frequently Asked Questions about dataform-engineering-fundamentals

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

FAQPage Schema
How do I enforce test-driven development for Dataform SQLX pipelines?

To enforce test-driven development for Dataform SQLX pipelines, you must write assertions and tests before implementation, ensuring robust data transformations and preventing technical debt before deploying to BigQuery.

What are the essential safety practices for BigQuery Dataform development?

Essential BigQuery Dataform safety practices mandate using the --schema-suffix dev command for isolated development and executing --dry-run to validate SQLX transformations, preventing costly production errors and ensuring safe pipeline deployments.

Why should I use ${ref()} instead of hardcoded table paths in Dataform?

You should use ${ref()} instead of hardcoded table paths in Dataform to enforce correct dependency management, ensuring pipelines execute in the proper sequence and maintain robust architectural structures within BigQuery.

Can I manage incremental updates and full refreshes safely under tight deadlines?

You can safely manage incremental updates and full refreshes under tight deadlines by following structured architectural patterns, mandating comprehensive columns documentation, and utilizing enforced safety checks to prevent pipeline failures.

What is the best way to document columns in Dataform SQLX files?

The best way to document columns in Dataform SQLX files is by requiring comprehensive columns: {} documentation blocks for all tables, ensuring maintainability and preventing technical debt across data engineering pipelines.

How do I troubleshoot common Dataform errors during pipeline development?

To troubleshoot common Dataform errors during pipeline development, follow structured troubleshooting protocols that address SQLX file creation, source declarations, and dependency management failures, ensuring rapid resolution under high-pressure scenarios.