CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-kusto

Query and analyze data in Azure Data Explorer (Kusto/ADX) using KQL for log analytics, telemetry, and time series analysis. WHEN: KQL queries, Kusto database queries, Azure Data Explorer, ADX clusters, log analytics, time series data, IoT telemetry, anomaly detection.

59

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./.github/plugins/azure-skills/skills/azure-kusto/SKILL.md
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.

The body is genuinely actionable with five executable KQL patterns and a concrete CLI fallback path, but it is held back by redundancy (two overlapping best-practices sections plus a marketing-style overview) and an abstract core workflow whose steps carry no commands or validation checkpoints. The single-file layout inlines reference-style material that would be better split out.

Suggestions

Merge the 'KQL Best Practices' and 'Best Practices' sections into one list and cut the marketing-style Overview paragraph ('sub-second query performance on billions of records') to tighten conciseness.

Attach concrete tool calls or commands to each 'Core Workflow' step (e.g. step 1: 'kusto_cluster_list' then 'kusto_database_list') and add an explicit checkpoint such as verifying schema before querying.

Add one example MCP tool invocation showing the actual parameter format alongside the parameter table, and consider moving the CLI fallback reference and KQL function list into a references/ file to reduce SKILL.md length.

DimensionReasoningScore

Conciseness

The body is mostly efficient (lean KQL examples, tight tables) but includes unnecessary or duplicated material: the 'KQL Best Practices' and 'Best Practices' sections repeat the same advice (time filters, take/limit, summarize), and the 'Overview' restates marketing copy ('sub-second query performance on billions of records') Claude does not need. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level-4 anchor.

3 / 5

Actionability

Five complete, executable KQL patterns (where/take, summarize/bin, percentiles with render timechart, join kind=inner) plus a concrete CLI fallback table and a working 'az rest' command give mostly copy-paste-ready guidance. The minor gap is that MCP tool usage is described via parameter tables only, with no example tool invocation showing the actual call format, so it falls just short of the fully-executable level-5 anchor.

4 / 5

Workflow Clarity

The 'Core Workflow' lists a clear 4-step sequence (Discover Resources, Explore Schema, Query Data, Analyze Results) but the steps are abstract with no commands attached, and validation checkpoints are absent from the workflow itself — error handling lives in separate 'Common Issues' and 'When to Fallback' sections rather than in-line checkpoints. This matches 'steps listed but validation gaps; checkpoints missing or implicit' rather than the level-4 anchor where most checkpoints accompany the steps.

3 / 5

Progressive Disclosure

The skill is a single ~230-line file with no reference files at all; it is well-sectioned with clear headers, but content that could live in separate files (the CLI fallback reference, the detailed KQL function list, use cases) is inlined. This fits 'some structure but could be better organized; content that should be separate is inline' — above the minimal-structure level-2 anchor thanks to consistent headers, but below level-4 since nothing is split out despite the length exceeding what a single-file overview warrants.

3 / 5

Total

13

/

20

Passed

Description

78%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 with an explicit and well-structured WHEN trigger clause and clear domain identification. Its main weakness is that only two generic verbs ('query and analyze') surface the skill's actual capability set, under-selling schema exploration and resource management described in the body.

DimensionReasoningScore

Specificity

The description names the domain ('Azure Data Explorer (Kusto/ADX) using KQL') and two concrete actions ('Query and analyze data'), matching the level-3 anchor of 1-2 concrete actions without comprehensive coverage. It omits capabilities the body demonstrates (schema discovery, cluster/database listing, aggregation/anomaly detection), keeping it below the level-4 'several specific actions' anchor.

3 / 5

Completeness

It clearly answers 'what' ('Query and analyze data in Azure Data Explorer (Kusto/ADX) using KQL for log analytics, telemetry, and time series analysis') and 'when' via an explicit 'WHEN:' clause with concrete trigger phrases, exactly matching the level-5 anchor. Unlike the level-4 anchor, the 'when' is not merely present but explicit and specific.

5 / 5

Trigger Term Quality

The WHEN clause covers good natural keywords users would actually say: 'KQL queries', 'Kusto database queries', 'Azure Data Explorer', 'ADX clusters', 'log analytics', 'IoT telemetry', 'anomaly detection'. A few natural variations are missing (e.g. 'Kusto Explorer', 'ADX' standalone beyond cluster phrasing, 'query performance'), placing it at the 'good coverage, a few natural terms missing' anchor rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

Kusto/KQL/ADX are a clear niche with distinct triggers, but 'log analytics', 'time series data', and 'anomaly detection' create minor overlap risk with Azure Monitor Log Analytics or generic analytics skills. This fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict level-5 anchor.

4 / 5

Total

16

/

20

Passed

Validation

100%

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
microsoft/azure-skills
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.