tools-only dbt Skills Repository
This repository contains skills for AI agents working with dbt projects.
Creating and Modifying Skills
This repo uses the superpowers skill framework. When creating or modifying skills:
- Use the superpowers:writing-skills skill - It provides TDD-based methodology for skill creation including pressure testing
- Follow the Iron Rule - Test skills with pressure scenarios before deploying
The superpowers marketplace is configured in .claude/settings.json and will be auto-installed when you trust this repo.
Skill Requirements
Every SKILL.md must have valid frontmatter:
---
name: skill-name-in-lowercase
description: Brief one-sentence description starting with "Use when..."
---
Critical Rules:
nameMUST be lowercase with hyphens only (letters, digits, hyphens)nameMUST match the directory name exactly- Only allowed fields:
name,description,allowed-tools,compatibility,license,metadata - NO
version,author, ortagsfields (these will cause validation errors if not put insidemetadata:
Common Validation Errors
| Error | Fix |
|---|---|
| "Unexpected fields in frontmatter" | Remove version, author, tags or other non-allowed fields |
| "Skill name must be lowercase" | Change Run Incremental Models to run-incremental-models |
| "Directory name must match skill name" | If skill name is run-models, directory must be run-models/ |
| "Contains invalid characters" | Use only lowercase letters, digits, and hyphens in skill name |
Before Committing
- Test with pressure scenarios using superpowers:writing-skills methodology
- Check naming: Skill name matches directory, lowercase with hyphens only
- Verify frontmatter: Only allowed fields, no extra metadata