Compile Project

Validate dbt and Lightdash project configurations locally using the Lightdash CLI.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/yu-iskw/dbt-heros --skill compile-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Compile Project
Source: https://github.com/yu-iskw/dbt-heros/tree/main/plugins/lightdash-development/skills/compile-project
Command: npx skills add https://github.com/yu-iskw/dbt-heros --skill compile-project

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that your dbt and Lightdash project configurations are syntactically correct and logically sound before deployment, preventing errors and wasted effort.

Core Features & Use Cases

  • Local Validation: Runs lightdash compile to check dbt projects and Lightdash YAML files.
  • Selective Compilation: Allows focusing compilation on specific models using dbt's selection syntax.
  • Use Case: After updating a metric definition in Lightdash or a dbt model, run this skill to confirm everything is valid before pushing changes.

Quick Start

Run lightdash compile to validate the current project.

Frequently Asked Questions about Compile Project

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

FAQPage Schema
How do I validate dbt and Lightdash project configurations locally?

You can validate dbt and Lightdash configurations locally by running `lightdash compile`, which checks YAML files and dbt models for syntactic and logical correctness before deployment to prevent errors.

Can I compile specific dbt models instead of the entire Lightdash project?

Yes, selective compilation allows you to target specific dbt models and their dependencies using dbt's node selection syntax, ensuring you only validate the updated parts of your project.

What is the best way to check Lightdash YAML files for errors before pushing changes?

Running a local validation check using `lightdash compile` is the best way to verify Lightdash YAML files and dbt metric definitions are logically sound before pushing any changes.

Does Lightdash CLI support dbt node selection syntax for targeted validation?

Yes, Lightdash CLI supports dbt's node selection syntax during compilation, allowing you to focus validation on specific models and their downstream or upstream dependencies.

When should I run a dbt project validation check?

You should run a dbt project validation check after updating a metric definition in Lightdash or modifying a dbt model, ensuring all configurations remain valid before deployment.