CtrlK
BlogDocsLog inGet started
Tessl Logo

dbt-labs/dbt-agent-skills

A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively.

91

Does it follow best practices?

Validation for skill structure

This version of the tile failed moderation
Moderation failed
Overview
Skills
Evals
Files

fetching-dbt-docs

skills/dbt/skills/fetching-dbt-docs/SKILL.md

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 well-structured skill description with explicit 'Use when' guidance and good coverage of dbt-specific trigger terms. The main weakness is that the capability description could be more specific about what concrete actions are possible beyond 'retrieves and searches'. Overall, it effectively communicates when Claude should select this skill.

Suggestions

Expand the capabilities section with more specific actions like 'find configuration syntax', 'look up CLI commands', or 'retrieve code examples' to improve specificity.

DimensionReasoningScore

Specificity

Names the domain (dbt documentation) and some actions ('retrieves and searches', 'LLM-friendly markdown format'), but doesn't list multiple specific concrete actions like extracting code examples, finding configuration syntax, or comparing versions.

2 / 3

Completeness

Clearly answers both what ('Retrieves and searches dbt documentation pages in LLM-friendly markdown format') and when ('Use when fetching dbt documentation, looking up dbt features, or answering questions about dbt Cloud, dbt Core, or the dbt Semantic Layer').

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'dbt documentation', 'dbt features', 'dbt Cloud', 'dbt Core', 'dbt Semantic Layer'. These cover the main product variants users would mention.

3 / 3

Distinctiveness Conflict Risk

Very clear niche focused specifically on dbt documentation with distinct product names (dbt Cloud, dbt Core, dbt Semantic Layer). Unlikely to conflict with general documentation or other data tool 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 demonstrates strong technical writing. It's concise yet comprehensive, using tables effectively to compress information, providing executable examples, and establishing a clear workflow with validation guidance through the 'Common Mistakes' section. The security considerations for handling external content are appropriately included.

DimensionReasoningScore

Conciseness

The content is lean and efficient, providing only essential information without explaining concepts Claude already knows. Tables are used effectively to compress information, and there's no unnecessary padding or explanation of what dbt or documentation is.

3 / 3

Actionability

Provides concrete, executable examples including exact URL patterns, bash commands with real examples, and copy-paste ready WebFetch commands. The script usage examples show multiple use cases with actual keywords.

3 / 3

Workflow Clarity

Clear two-step workflow for finding pages (search index first, then full docs only if needed). The sequence is explicit with 'Step 1' and 'Step 2' labels, and the 'Common Mistakes' table serves as a validation checklist to catch errors.

3 / 3

Progressive Disclosure

Well-organized with clear sections progressing from overview to quick reference to detailed usage. Content is appropriately contained in a single file given its scope, with external script reference clearly signaled. No unnecessary nesting or monolithic walls of text.

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed