running-dbt-commands
Use when executing dbt commands via CLI - running models, tests, builds, compiles, or show queries. Use when unsure which dbt executable to use or how to format command parameters.
Install with Tessl CLI
npx tessl i github:dbt-labs/dbt-agent-skills --skill running-dbt-commands95
Quality
95%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description with clear 'Use when' triggers and good coverage of dbt-specific terminology. The main weakness is that it focuses more on when to use the skill than what specific capabilities it provides - it lists command types but doesn't explain what the skill actually does with them (e.g., 'formats commands', 'selects correct executable').
Suggestions
Add more specific capability descriptions before the 'Use when' clause, such as 'Formats and executes dbt CLI commands, selects the appropriate dbt executable, and structures command parameters correctly.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (dbt CLI) and lists several actions (running models, tests, builds, compiles, show queries), but doesn't describe what these actions accomplish or provide comprehensive detail about capabilities. | 2 / 3 |
Completeness | Explicitly answers both what (executing dbt commands - models, tests, builds, compiles, show queries) and when (via 'Use when' clauses covering command execution and uncertainty about executables/parameters). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'dbt commands', 'CLI', 'running models', 'tests', 'builds', 'compiles', 'show queries', 'dbt executable', 'command parameters' - good coverage of terms a dbt user would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific to dbt CLI execution with distinct triggers like 'dbt executable', 'dbt commands', specific dbt operations - unlikely to conflict with general database or other CLI skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that exemplifies best practices. It's highly actionable with executable commands, efficiently organized with tables and clear sections, and includes validation patterns (list before run, warn-error-options). The Common Mistakes section proactively addresses error scenarios.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what dbt is or how it works. Every section provides actionable commands and tables without padding. Assumes Claude knows dbt fundamentals. | 3 / 3 |
Actionability | Fully executable commands throughout with copy-paste ready examples. Concrete bash commands, specific flag combinations, and real jq queries for analyzing results. No pseudocode or vague descriptions. | 3 / 3 |
Workflow Clarity | Clear preferences hierarchy (1-4), explicit validation pattern with `dbt list` before running, and a 'Common Mistakes' table that serves as error prevention. The warn-error-options pattern catches selector typos as a validation checkpoint. | 3 / 3 |
Progressive Disclosure | Well-organized with clear section headers, quick reference at top for common patterns, and detailed sections below. Tables used effectively for CLI flavors, selectors, and common mistakes. Appropriate length without needing external file references. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 13 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
license_field | 'license' field is missing | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 13 / 16 Passed | |
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.