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.
67
58%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugin/skills/azure-kusto/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description with excellent trigger term coverage and clear completeness via an explicit WHEN clause. The main weakness is that the 'what' portion could be more specific about concrete actions beyond 'query and analyze data'. Overall it would perform well in skill selection scenarios.
Suggestions
Expand the capability description with more specific concrete actions, e.g., 'Write and optimize KQL queries, build summarization pipelines, detect anomalies in time series, join across tables and clusters' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Azure Data Explorer/Kusto/KQL) and some actions ('query and analyze data'), but doesn't list multiple specific concrete actions like creating queries, joining tables, building dashboards, or specific KQL operations. | 2 / 3 |
Completeness | Clearly answers both 'what' (query and analyze data in Azure Data Explorer using KQL for log analytics, telemetry, and time series analysis) and 'when' (explicit WHEN clause listing trigger scenarios like KQL queries, Kusto database queries, ADX clusters, etc.). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'KQL queries', 'Kusto database queries', 'Azure Data Explorer', 'ADX clusters', 'log analytics', 'time series data', 'IoT telemetry', 'anomaly detection'. These cover multiple natural variations and synonyms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche around Azure Data Explorer/Kusto/KQL. The specific technology stack (ADX, KQL, Kusto) and use cases (IoT telemetry, log analytics) make it very unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill covers Azure Data Explorer comprehensively but suffers from significant verbosity and redundancy. It explains concepts Claude already knows (what ADX is, what KQL is, common use cases), duplicates best practices across sections, and includes an unnecessary activation triggers section. The KQL examples are a strength, but the lack of progressive disclosure and missing validation checkpoints in workflows weaken the overall quality.
Suggestions
Remove the 'Skill Activation Triggers', 'Overview', 'Key Data Fields', 'Result Format', and 'Use Cases' sections entirely — Claude already knows what ADX is and when to use this skill based on the frontmatter description.
Merge the two 'Best Practices' sections into a single concise list, removing general advice Claude already knows (like 'monitor query performance') and keeping only ADX-specific gotchas.
Split the CLI fallback reference, detailed query patterns, and common functions into separate bundle files (e.g., FALLBACK_CLI.md, QUERY_PATTERNS.md, KQL_REFERENCE.md) and reference them from a much shorter SKILL.md.
Add explicit validation steps to the core workflow, e.g., 'Verify query returns expected columns before aggregating' and 'Check row count — if 0, widen time range or verify table name before proceeding.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Significant verbosity throughout. The 'Skill Activation Triggers' section is unnecessary (Claude doesn't need to be told when to activate). The 'Overview' section explains what Azure Data Explorer is, which Claude already knows. 'Key Data Fields', 'Result Format', 'Use Cases', and much of 'Best Practices' are general knowledge padding. The 'KQL Best Practices' and 'Best Practices' sections overlap substantially. The file is well over 150 lines with much content that doesn't earn its place. | 1 / 3 |
Actionability | The KQL examples are concrete and executable, and the MCP tool table with parameters is useful. However, the CLI fallback query example uses placeholders rather than a fully worked example, and the core workflow is described abstractly (steps 1-4) without concrete tool invocations showing how to chain discovery → schema → query together. The skill describes patterns more than it instructs. | 2 / 3 |
Workflow Clarity | The 'Core Workflow' section lists four steps but lacks explicit validation checkpoints or feedback loops. There's no guidance on verifying query results, handling partial failures, or iterating when queries return unexpected results. The fallback strategy section is a good addition but the transition criteria ('When to Fallback') are listed without a clear decision sequence. For a skill involving potentially expensive queries on large datasets, missing validation caps this at 2. | 2 / 3 |
Progressive Disclosure | All content is in a single monolithic file with no bundle files or references to external documents. The KQL best practices, common functions reference, CLI fallback commands, and detailed query patterns could all be split into separate reference files. The inline content is extensive and would benefit greatly from a layered structure with a concise overview pointing to detailed references. | 1 / 3 |
Total | 6 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
771a666
Table of Contents
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.