databricks-unstructured-pdf-generation

Generate PDF documents from HTML and upload to Unity Catalog volumes. Use for creating test PDFs, demo documents, reports, or evaluation datasets.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

65%

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

The body is highly actionable with executable examples, but it is verbose with HTML/CSS templates Claude could derive and its batch workflow lacks an explicit success/error verification checkpoint. There are no separate reference files, so reference-like templates sit inline.

Suggestions

Add an explicit verification step to the multi-document workflow that checks each call's returned success/error and retries or reports failures before summarizing, since parallel generation is a batch operation.

Move the full 'Professional Document Template' and the three 'Common Patterns' examples into a separate references file and link to it, keeping only one minimal example inline to reduce tokens.

Trim explanations of basic HTML5 structure and supported CSS features, which Claude already understands, to lean the overview toward only the tool-specific behavior.

Dimension	Reasoning	Score
Conciseness	The tool signature, quick start, and parallel guidance are efficient, but large inline HTML/CSS templates, a full 'Professional Document Template', and three full 'Common Patterns' examples explain styling Claude already knows and could be tightened.	2 / 3
Actionability	Provides fully executable generate_and_upload_pdf calls with concrete parameters, complete HTML documents, and copy-paste-ready examples across multiple patterns.	3 / 3
Workflow Clarity	The multi-document workflow is sequenced (Plan, Generate HTML, Call in parallel, Report results) but for a batch operation it lacks an explicit verification checkpoint inspecting the returned success/error before reporting, capping it at 2 per the batch-operations guideline.	2 / 3
Progressive Disclosure	Sections are clearly labeled, but the skill is a single monolithic file with substantial inline reference-style material (full templates, multiple pattern examples) that is not split into or signaled by separate reference files; no bundle files exist.	2 / 3
	Total	9 / 12 Passed

Description

100%

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

The description is concise, specific, and answers both 'what' and 'when' with an explicit 'Use for' clause, hitting all anchor-3 criteria. It uses third person and avoids fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Generate PDF documents from HTML and upload to Unity Catalog volumes' — naming the input, output, and destination rather than vague abstraction.	3 / 3
Completeness	Explicitly states both what it does (generate PDFs from HTML, upload to Unity Catalog volumes) and when to use it via a clear 'Use for creating...' clause.	3 / 3
Trigger Term Quality	'test PDFs, demo documents, reports, or evaluation datasets' covers natural use-case terms users would plausibly say, matching the good-example style of enumerating concrete triggers.	3 / 3
Distinctiveness Conflict Risk	The HTML-to-PDF plus Unity Catalog volume upload niche is distinct, and the 'Use for' triggers are specific enough to avoid triggering for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: databricks-solutions/ai-dev-kit
Path: databricks-skills/databricks-unstructured-pdf-generation/SKILL.md
Commit: a7e1d51

Reviewed: about 5 hours ago

Table of Contents

Discovery Implementation Validation

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.