CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-zerobus-ingest

Push records from apps, services, devices, or scripts directly into Unity Catalog Delta tables with Zerobus Ingest: SDKs (Python, TypeScript, Go, Java, Rust, C++, .NET), REST, OTLP, MQTT, Arrow Flight, or Apache Kafka-compatible producer APIs, with no message bus to run. Use to stream events, telemetry, logs, IoT data, CDC, or columnar batches into Databricks in near real time; connect existing collectors and log shippers (OpenTelemetry, Debezium, Vector, Telegraf, Cribl); replace a message bus that only feeds the lakehouse; or debug Zerobus auth, schema, throughput, or delivery issues.

75

Quality

94%

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

88%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.

The body is a strong, dense operating manual: a sequenced workflow with real validation gates, executable code and commands, and an excellent one-level reference map. Weaknesses are contained: volatile SDK version numbers in the main body, some restatement of key facts, and two links to a missing examples/ directory.

Suggestions

Ship the referenced examples/ directory (mqtt_producer.py, grpc_client.py) or remove/redirect those two links, since Claude following them will fail to find the promised runnable programs.

Move the per-SDK release status and 'Available since X.Y.0' version numbers out of SKILL.md into a reference or the linked SDK README table, keeping only the stable record-format matrix in the body.

Trim restated facts — the ~150 ms durable / ~5 s queryable timing appears three times and the non-blocking ladder is repeated between Step 4 and Key facts; stating each once in Key facts (with links) would save tokens without losing clarity.

DimensionReasoningScore

Conciseness

The body is dense with Zerobus-specific facts Claude wouldn't know (non-blocking ladder, durable-vs-queryable timing, grant requirements) rather than padded explanation, but it is not fully lean: volatile SDK version numbers ("Available since 1.8.0", "Beta", "In development") sit in the main body instead of a maintenance/versions section, and key facts are restated (the ~150 ms / ~5 s timing appears three times; the non-blocking ladder is repeated in Key facts). This sits above 'mostly efficient but includes some unnecessary explanation' (3) but below 'every token earns its place' (5).

4 / 5

Actionability

Guidance is copy-paste ready: a complete runnable Python producer with env-var credentials and an ack callback, exact CLI verification commands (`databricks experimental aitools tools query ...`), a prerequisite table with per-row verify commands, a blocking-behavior ladder naming exact methods (`ingest_record_offset()`, `flush()`, `wait_for_offset()`), and a symptom-to-fix troubleshooting table. This matches the anchor for fully executable guidance covering common cases.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced with explicit validation checkpoints and feedback loops: a plan-approval gate before creating resources, a prerequisite table with "Don't run a producer until every row passes", a small test batch, and a verify step with expected results plus an explicit failure path ("If not, read references/troubleshooting.md"). Not a 4, because validation is explicit at each risky stage rather than mostly present with gaps.

5 / 5

Progressive Disclosure

The reference map is a well-signaled, one-level-deep table of 24 files each with a 'when to read' trigger, and all references/*.md links and anchors resolve. However, scoring against the actual bundle reveals two broken references: examples/mqtt_producer.py and examples/grpc_client.py are cited ("Long runnable programs for MQTT and the raw gRPC API are in examples/") but the examples/ directory does not exist in the bundle. Good structure with a real but contained navigation gap fits the anchor at 4; a 5 would require every referenced path to resolve.

4 / 5

Total

18

/

20

Passed

Description

100%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.

The description is exemplary: third-person voice, concrete enumerated actions, comprehensive natural trigger terms, and an explicit 'Use to' clause covering streaming, collector integration, bus replacement, and debugging. It clearly answers both what the skill does and when to use it with minimal conflict risk.

DimensionReasoningScore

Specificity

Multiple concrete actions are explicitly enumerated — "Push records from apps, services, devices, or scripts directly into Unity Catalog Delta tables", "connect existing collectors and log shippers", "replace a message bus that only feeds the lakehouse", "debug Zerobus auth, schema, throughput, or delivery issues" — with every interface named (SDKs, REST, OTLP, MQTT, Arrow Flight, Kafka-compatible APIs). This matches the anchor for comprehensive, specific concrete actions; a 4 would require minor coverage gaps, but the what/connect/replace/debug span leaves none.

5 / 5

Completeness

Both questions are answered explicitly: the what is the opening sentence (push records into Unity Catalog Delta tables via the listed interfaces), and the when is an explicit "Use to stream… connect… replace… or debug" clause with concrete trigger phrases. This mirrors the anchor-5 example structure; a 4 would need a vaguer or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural user vocabulary is comprehensively covered: "stream events, telemetry, logs, IoT data, CDC", "near real time", "columnar batches", plus the specific tool names users would mention (OpenTelemetry, Debezium, Vector, Telegraf, Cribl, MQTT, Kafka). Both synonyms and product-specific terms are present, matching the top anchor rather than the 'a few natural terms missing' anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and branded — Zerobus Ingest, Unity Catalog Delta tables, Databricks, lakehouse feeding — and the 'when' triggers are anchored to that destination context, giving minimal overlap risk with generic logging or Kafka skills. Not a 4, because the description doesn't merely reduce overlap risk; it names proprietary triggers (Zerobus, Unity Catalog) that no other skill would claim.

5 / 5

Total

20

/

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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

plugins/databricks/claude/skills/databricks-zerobus-ingest/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.