CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-eventhub-py

Azure Event Hubs SDK for Python streaming. Use for high-throughput event ingestion, producers, consumers, and checkpointing.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/azure-eventhub-py/SKILL.md

The canonical home for this skill is azure-eventhub-py in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-organized, largely executable API cookbook for the Azure Event Hubs SDK. Its main defects are broken bundle references (cited files don't exist), one non-runnable async snippet (missing EventData import), unused environment-variable config, and repeated client-setup boilerplate across sections.

Suggestions

Ship or remove the referenced bundle files: references/checkpointing.md, references/partitions.md, and scripts/setup_consumer.py are listed in the 'Reference Files' table but are absent from the skill, so every navigation pointer dead-ends.

Fix the async example's missing import ('from azure.eventhub import EventData') so the snippet runs, and either wire the Environment Variables section into the code samples or delete it.

Tighten conciseness by showing client construction once in the Authentication section and referencing it from Send/Receive/Checkpoint examples, and delete the filler 'When to Use' sentence that restates the overview without adding information.

DimensionReasoningScore

Conciseness

The body is code-dominant with little concept explanation, but it can be tightened: client construction (namespace, eventhub_name, credential) is repeated verbatim across the Authentication, Send, Receive, and Checkpoint sections; the opening line ('Big data streaming platform for high-throughput event ingestion') duplicates the frontmatter description; and 'This skill is applicable to execute the workflow or actions described in the overview' is meaningless filler. Mostly efficient with some unnecessary repetition fits anchor 3, not 2 (no concept-level padding) and not 4 (the repetition and filler are noticeable).

3 / 5

Actionability

Snippets are real, executable Azure SDK code — including correct batch-full handling ('except ValueError: ... send and create new one') and partition-key usage — but there are concrete defects: the async example uses 'EventData' without importing it ('from azure.eventhub.aio import ...' does not provide it, so the snippet NameErrors), and the Environment Variables section defines four variables that no code sample ever reads. Concrete guidance with missing key details matches anchor 3 rather than 4 (minor gaps) — a broken import and dead config are more than minor.

3 / 5

Workflow Clarity

The install → env → auth → send → receive → async progression is implicit in section order, and batch sends include an inline error checkpoint ('except ValueError'), but there is no explicit workflow sequencing, no validation that events were delivered, and no retry/error-recovery guidance for consumers. Sequence present with checkpoints missing or implicit matches anchor 3; not 4 since validation gaps go beyond minor.

3 / 5

Progressive Disclosure

Section structure is clear and the 'Reference Files' table is a well-signaled navigation aid, but the three cited bundle files (references/checkpointing.md, references/partitions.md, scripts/setup_consumer.py) do not exist in the skill bundle — following any reference dead-ends. Per the guideline to score against the actual bundle structure, this lands at anchor 3: structure present, references signaled, but organization is undermined; not 2 because the inline content is not a monolithic dump and references are prominently placed, not buried.

3 / 5

Total

12

/

20

Passed

Description

75%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 solid description that explicitly covers both what and when in third person with distinct domain triggers. Its weaknesses are framing capabilities as roles rather than actions and missing common user phrasings like 'send events' or 'consume events'.

DimensionReasoningScore

Specificity

Names the domain ('Azure Event Hubs SDK for Python streaming') and several concrete capabilities ('event ingestion, producers, consumers, and checkpointing'), but frames them as roles rather than actions — missing 'send/receive events', batching, or partition management. Anchor 4 ('several specific actions; minor gaps') fits better than 5 (comprehensive action coverage) and clearly above 3 (only 1-2 concrete actions).

4 / 5

Completeness

Both parts are explicit: what ('Azure Event Hubs SDK for Python streaming') and when ('Use for high-throughput event ingestion, producers, consumers, and checkpointing'). Not anchor 5 because the 'what' is a product-identification fragment rather than a concrete action statement, and the 'when' clause lists topics rather than user trigger phrases.

4 / 5

Trigger Term Quality

Includes natural domain terms users would say ('Azure Event Hubs', 'streaming', 'event ingestion', 'producers', 'consumers', 'checkpointing'), but misses common phrasings like 'send events', 'read/consume events', 'event streaming', or 'pub/sub'. Good coverage with a few natural terms missing matches anchor 4, short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Azure Event Hubs' pins a clear niche with minimal conflict, but the broad phrases 'streaming' and 'high-throughput event ingestion' could pull in generic event-streaming skills (Kafka, Kinesis, Service Bus). Mostly distinct with minor overlap risk against closely related skills matches anchor 4.

4 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/azure-eventhub-py/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.