Content
88%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |