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
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |