Skip to content

Add dbt-agent-skills as git submodule#140

Draft
tayloramurphy wants to merge 2 commits intomainfrom
add-dbt-agent-skills
Draft

Add dbt-agent-skills as git submodule#140
tayloramurphy wants to merge 2 commits intomainfrom
add-dbt-agent-skills

Conversation

@tayloramurphy
Copy link
Collaborator

Summary

  • Adds dbt-labs/dbt-agent-skills as a git submodule in vendor/dbt-agent-skills
  • Symlinks 10 individual skills into skills/ so they're auto-discovered by the plugin system
  • No changes to existing skills or plugin configuration

How it works

The submodule pins to a specific commit in the dbt-agent-skills repo. Symlinks in skills/ point through vendor/ so auto-discovery finds them at the expected skills/*/SKILL.md path.

vendor/dbt-agent-skills/          ← submodule (full repo)
skills/running-dbt-commands/      ← symlink → ../vendor/dbt-agent-skills/skills/dbt/skills/running-dbt-commands
skills/adding-dbt-unit-test/      ← symlink → ../vendor/dbt-agent-skills/skills/dbt/skills/adding-dbt-unit-test
...

Skills added

Skill Source group
adding-dbt-unit-test dbt
answering-natural-language-questions-with-dbt dbt
building-dbt-semantic-layer dbt
configuring-dbt-mcp-server dbt
fetching-dbt-docs dbt
running-dbt-commands dbt
troubleshooting-dbt-job-errors dbt
using-dbt-for-analytics-engineering dbt
migrating-dbt-core-to-fusion dbt-migration
migrating-dbt-project-across-platforms dbt-migration

Things to evaluate

  • Clone experience: new clones need git clone --recurse-submodules or git submodule update --init after clone
  • CI/CD: pipelines need submodule checkout enabled
  • Symlinks on Windows: works on macOS/Linux; Windows needs developer mode
  • Update workflow: bumping the submodule to a newer commit is a manual cd vendor/dbt-agent-skills && git pull && cd ../.. && git add vendor/dbt-agent-skills && git commit

Test plan

  • Verify skills/*/SKILL.md resolves through symlinks
  • Test fresh clone with --recurse-submodules
  • Test plugin install and verify dbt skills appear
  • Verify existing skills are unaffected

Adds dbt-labs/dbt-agent-skills as a git submodule in vendor/ and
symlinks individual skills into skills/ for auto-discovery.

Includes 10 dbt skills:
- adding-dbt-unit-test
- answering-natural-language-questions-with-dbt
- building-dbt-semantic-layer
- configuring-dbt-mcp-server
- fetching-dbt-docs
- migrating-dbt-core-to-fusion
- migrating-dbt-project-across-platforms
- running-dbt-commands
- troubleshooting-dbt-job-errors
- using-dbt-for-analytics-engineering
@tayloramurphy tayloramurphy changed the title Add dbt-agent-skills as git submodule draft: Add dbt-agent-skills as git submodule Feb 25, 2026
@tayloramurphy tayloramurphy changed the title draft: Add dbt-agent-skills as git submodule Add dbt-agent-skills as git submodule Feb 25, 2026
@tayloramurphy tayloramurphy marked this pull request as draft February 25, 2026 16:58
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.

1 participant