Skip to content

feat(lfx-data-engineer): add new skill for generating dbt models and …#48

Open
skalepp wants to merge 3 commits intomainfrom
feat/create-data-engineer-skill
Open

feat(lfx-data-engineer): add new skill for generating dbt models and …#48
skalepp wants to merge 3 commits intomainfrom
feat/create-data-engineer-skill

Conversation

@skalepp
Copy link
Copy Markdown

@skalepp skalepp commented Apr 10, 2026

This pull request adds comprehensive documentation and support for the new /lfx-data-engineer skill, which generates PR-ready dbt models and SQL transformations. It updates the main README.md to describe this new skill, details its capabilities, and integrates it into the skill system overview and directory structure. Additionally, it introduces a set of reference guides for dbt development, including setup, debugging, style, and workflow documentation.

Skill system and documentation updates:

  • Added /lfx-data-engineer to the skill list, skill system diagram, and skill table in README.md, describing its purpose as a dbt model and SQL transformation generator. [1] [2] [3]
  • Documented /lfx-data-engineer in detail, outlining medallion architecture layers, key capabilities, and included reference docs.
  • Updated the skill workflow section and project directory structure to include /lfx-data-engineer and its references. [1] [2]

Reference documentation for dbt development:

  • Added lfx-data-engineer/references/getting-started.md with environment setup, dbt commands, Makefile targets, and project structure guidance.
  • Added lfx-data-engineer/references/debugging-pipelines.md covering common dbt and sqlfluff errors, troubleshooting, and debugging workflow.

These changes ensure that both the skill system and its documentation are up to date, and provide clear onboarding and troubleshooting resources for data engineering tasks in the project.

…SQL transformations

Introduces the `/lfx-data-engineer` skill to guide users in creating PR-ready dbt models, tests, and SQL transformations. This skill encodes the medallion architecture, Snowflake SQL conventions, and includes comprehensive references for setup, debugging, and style guidelines.

New references added:
- `getting-started.md`: Initial setup and prerequisites for using lf-dbt.
- `medallion-architecture.md`: Overview of the medallion architecture layers.
- `sql-style-guide.md`: Consolidated SQL formatting rules.
- `debugging-pipelines.md`: Common failure patterns and resolutions.
- `key-macros.md`: Reference for frequently used macros in the project.

The README has been updated to include the new skill and its capabilities.

Signed-off-by: Shane Kalepp <shane.kalepp@yahoo.com>
@skalepp skalepp self-assigned this Apr 10, 2026
Copilot AI review requested due to automatic review settings April 10, 2026 19:34
@skalepp skalepp requested review from dealako and niravpatel27 April 10, 2026 19:36
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new /lfx-data-engineer skill to the LFX skills system, including end-user documentation and reference guides aimed at producing PR-ready dbt models and SQL transformations aligned to lf-dbt conventions.

Changes:

  • Integrated /lfx-data-engineer into the main README (skill list, architecture diagram, skill table, workflows, and repo structure).
  • Added the /lfx-data-engineer skill definition with workflows, validation expectations, and conventions.
  • Added dbt reference docs (getting started, debugging, style guide, testing patterns, medallion architecture, key macros).

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
README.md Documents the new skill across the skill system overview, workflows, and directory structure.
lfx-data-engineer/SKILL.md Defines the skill’s behavior, conventions, validation steps, and examples for dbt development.
lfx-data-engineer/references/getting-started.md Onboarding guide for lf-dbt environment setup and common commands.
lfx-data-engineer/references/debugging-pipelines.md Troubleshooting guide for dbt/sqlfluff failures and debugging workflow.
lfx-data-engineer/references/sql-style-guide.md SQL formatting and linting conventions aligned to sqlfluff + project standards.
lfx-data-engineer/references/testing-patterns.md dbt YAML testing conventions (patterns, config nesting, PII tagging).
lfx-data-engineer/references/medallion-architecture.md Explains layer responsibilities, conventions, examples, and schema mapping.
lfx-data-engineer/references/key-macros.md Reference documentation for commonly used lf-dbt macros and their intended usage.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread lfx-data-engineer/SKILL.md
Comment thread lfx-data-engineer/references/debugging-pipelines.md Outdated
niravpatel27
niravpatel27 previously approved these changes Apr 13, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Shane Kalepp <40646811+skalepp@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Shane Kalepp <40646811+skalepp@users.noreply.github.com>
@skalepp skalepp requested a review from niravpatel27 April 15, 2026 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants