CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sentinel-xdr-detection-validator

Validate generated XDR Detection YAML structurally and validate source and converted KQL through official Microsoft Sentinel Triage MCP tools first, with direct API fallback.

Quality

75%

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/skills/sentinel-xdr-detection-validator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 content is a strongly actionable, validation-heavy workflow with explicit commands, exact schemas, and genuine error-recovery loops — model workflow clarity for a batch validation skill. Its weaknesses are noticeable redundancy across the fallback and zero-rows rules and a monolithic inline structure that would benefit from one-level-deep reference files.

Suggestions

State each fallback and zero-rows rule once (e.g., consolidate the opening bullets with '## Provider fallback policy') and cut the step-7 restatements to save significant tokens.

Move the detailed policy blocks — provider-gap evidence schema, Authoring/Qualification profile rules, and entity-mapping review guidance — into one-level-deep reference files linked from the workflow, keeping SKILL.md as an overview.

Add a JSON example for provider-gap-<family>.json mirroring the normalized-results example, since it is currently only described in prose.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no explanations of concepts Claude already knows, but the fallback policy is restated three times (opening bullets, '## Provider fallback policy', and workflow step 7) and 'zero rows are not parity' is repeated across steps 9, 10, and the SDK paragraph, so it could be tightened; not 2 because there is no padded conceptual explanation.

3 / 5

Actionability

Gives exact executable commands with full flags ('sentinel-xdr-migration validate-sentinel-sdk --solution ... --run-id ...'), a complete normalized-results JSON example, exact version range '[3.1.0, 4.0.0)', allowed statuses, and reason codes — but the provider-gap-<family>.json artifact, a key deliverable, is specified only as a prose field list with no example, leaving a minor gap that keeps it below the fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The 11-step workflow has explicit validation checkpoints ('Stop if structural errors remain', 'Do not change contentProvenance.conversion.status to validated unless both queries execute') and genuine feedback loops (rerun the complete family after a query rewrite; re-review when content hashes change), which is exactly anchor 5 for a batch operation with validation.

5 / 5

Progressive Disclosure

No bundle files exist and no references to separate files are signaled; roughly 250 lines of dense policy (fallback rules, gap-evidence schemas, Authoring/Qualification profiles, entity-mapping review) that clearly belongs in one-level-deep reference files is all inlined. Section headers ('## Provider fallback policy', '## Workflow', '## Query-surface isolation') provide real structure, placing it above anchor 2, but the absence of any reference split keeps it below anchor 4.

3 / 5

Total

15

/

20

Passed

Description

70%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 specific and highly distinctive for the Sentinel XDR detection-validation niche, naming concrete actions and the provider mechanism. Its main weakness is the complete absence of a 'when to use' trigger clause, which both caps completeness and leaves natural trigger phrasing underdeveloped.

Suggestions

Add an explicit trigger clause, e.g. 'Use when validating or converting Sentinel/XDR detection rules, checking converted KQL, or when the user mentions XDR detections, Defender Advanced Hunting, or Sentinel migration.'

Include natural synonyms users would say — 'Defender', 'Advanced Hunting', 'detection rules', 'YAML validation' — alongside the current technical terms to improve trigger-term coverage.

Optionally mention the reporting/qualification outcomes the skill produces so the 'what' coverage matches the body's scope.

DimensionReasoningScore

Specificity

Lists several concrete actions with their mechanism — 'Validate generated XDR Detection YAML structurally', 'validate source and converted KQL', 'through official Microsoft Sentinel Triage MCP tools first, with direct API fallback' — but omits runtime planning, reporting, and provider-gap evidence covered in the body, so it is not comprehensive (not 5); it exceeds the 1-2 actions of anchor 3.

4 / 5

Completeness

The 'what' is clear and specific, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which the rubric caps at 3; it is above anchor 2 because the 'what' is concrete, and cannot be 4 without any 'when' element.

3 / 5

Trigger Term Quality

Includes good domain-natural keywords ('XDR Detection YAML', 'KQL', 'Microsoft Sentinel Triage MCP', 'API fallback') that a user in this niche would say, but misses common variations such as 'Defender', 'Advanced Hunting', 'detection rules', or 'migration', so it falls short of anchor 5 while clearly exceeding the single-generic-keyword level of anchor 3.

4 / 5

Distinctiveness Conflict Risk

'XDR Detection YAML', 'source and converted KQL', and 'Microsoft Sentinel Triage MCP' define a clear niche with distinct triggers and minimal overlap risk with any generic skill, matching anchor 5 exactly.

5 / 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

Azure/Azure-Sentinel

Path

.github/skills/sentinel-xdr-detection-validator/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.