CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

author-recipes-and-cookbooks

Author and maintain DevHub templates published at `developers.databricks.com/templates`. A template is the public name for any of three internal entry kinds — atomic snippets, multi-step end-to-end walkthroughs, and full deployable example apps. Use when creating, updating, or reorganizing any template-tier content.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable and well-sequenced skill: exact paths, fields, commands, and dialect rules, with explicit validation checkpoints and a fix-and-retry loop around the risky deploy steps. The main weakness is progressive disclosure — the provided references/quality-checklist.md is never referenced from the body, and substantial detail is inlined that would fit better in reference files — plus minor internal repetition.

Suggestions

Link references/quality-checklist.md from the body (e.g., from 'Validate Before Finishing') instead of leaving the bundle file orphaned and partially duplicated inline.

Move the example image contract, screenshot guidance, and the eight-row brand-color hex table into a separate reference file, keeping only the headline rules (16:9, both light and dark variants, run pnpm verify:images) in SKILL.md.

Trim repetition: drop the "So: recipes are the atoms..." summary sentence and fold the URL Structure table into the existing Internal Implementation Tiers table.

DimensionReasoningScore

Conciseness

The body is dense and nearly every line is a rule, path, or command; explanations (why the demos folder must be outside the repo, why pipelines live under template/) are project-specific knowledge Claude would not already have, not padding. Not 5 because there is noticeable redundancy — the "So: recipes are the atoms..." sentence restates the preceding bullets, the Overview repeats the frontmatter, and the URL Structure table partially repeats the Internal Implementation Tiers table; not 3 because these are minor tightenings, not whole padded sections.

4 / 5

Actionability

Guidance is fully executable throughout: exact file paths (content/recipes/<slug>/goal.md, src/lib/recipes/recipes.ts), exact registry fields, a copy-paste-ready dry-run bash block, exact SQL dialect substitutions ("Use CURRENT_DATE() not NOW()"), concrete image contracts (16:9 ±2%, 1600x900), and exact hex brand tokens. Not 4 because even the trickiest steps — cookbook page creation, example registration, cleanup — carry the specific fields, commands, or file locations needed to execute them.

5 / 5

Workflow Clarity

Sequences are explicit and checkpointed: a Decision Flow for kind selection, numbered authoring steps per kind, a 13-item "Validate Before Finishing" checklist, and a dry-run workflow with a validate-fix-retry feedback loop ("Code bug — fix in examples/<slug>/ in the repo, then re-copy to ../../demos/<slug>/ and retry") plus cleanup. Not 4 because destructive/deploy operations (bundle deploy, resource creation) are explicitly bracketed by validation steps and never-reuse-workspace-resources guards, leaving no validation gaps.

5 / 5

Progressive Disclosure

Sections are well-organized and there is a References section, but the skill's only actual bundle file, references/quality-checklist.md, is never linked from the body — its validation content overlaps with the inline "Validate Before Finishing" checklist instead of being pointed to — and detail-heavy material (image contracts, the eight-row hex palette, the full dry-run script) is inlined in a 325-line SKILL.md where it could live in reference files. Not 4 because the one provided reference file is orphaned rather than clearly signaled; not 2 because the body's own structure is strong and references in the final section are explicit, not buried.

3 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it names concrete authoring/maintenance actions, enumerates the three content kinds, scopes the skill to a specific site and product, and includes an explicit, specific "Use when" trigger clause. Minor room to grow in keyword variety (e.g., "add", "publish") and in making the middle definitional sentence carry additional actions.

DimensionReasoningScore

Specificity

Concrete actions are named — "Author and maintain DevHub templates", "creating, updating, or reorganizing any template-tier content" — and the three content kinds ("atomic snippets, multi-step end-to-end walkthroughs, and full deployable example apps") are enumerated. Not 5 because the middle sentence is definitional domain framing rather than additional concrete actions, so coverage is broad but not exhaustive; not 3 because it clearly lists several specific actions, not just 1-2.

4 / 5

Completeness

Explicitly answers both: what — "Author and maintain DevHub templates published at developers.databricks.com/templates" with the three entry kinds enumerated — and when — "Use when creating, updating, or reorganizing any template-tier content" with concrete trigger phrases. Not 4 because the when-clause is explicit, specific, and covers the main operation modes rather than being weakly implied.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "DevHub templates", "creating, updating, or reorganizing", "snippets", "walkthroughs", "example apps", plus the site URL. Not 5 because a few natural phrasings users would say ("add", "publish", "new template") are absent; not 3 because synonyms across all three kinds plus multiple operation verbs are present, not just a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

Scoped to a clear niche: DevHub templates at a specific published site, with a defined content tier ("template-tier content"), making it unlikely to trigger for unrelated skills. Not 4 because the site, product name, and content kinds together create minimal overlap risk with any other skill's triggers.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

databricks/devhub

Path

.agents/skills/author-recipes-and-cookbooks/SKILL.md

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.