CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sentinel-xdr-alert-parity-validator

Perform strict lab-only parity validation between a Microsoft Sentinel Analytic Rule and its migrated Defender XDR Custom Detection.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 an exemplary operational skill: executable commands with complete flags, fail-closed lifecycle handling, explicit acceptance criteria, and lean prose that assumes competence. The only improvement area is that a couple of the larger JSON schema blocks could be split into reference files to shorten the main body.

DimensionReasoningScore

Conciseness

The body is lean and skill-specific throughout — commands, JSON shapes, and policy bullets with no explanation of concepts Claude already knows (e.g. "Platform alert IDs are not comparable", "A genuine KQL error is not a reason to change providers"). Every token earns its place, matching the level 5 anchor rather than level 4's minor trimmable over-explanation.

5 / 5

Actionability

Fully executable, copy-paste-ready commands with complete flags (start-alert-parity-batch, start-alert-parity, complete-alert-parity, abort-alert-parity), concrete JSON fixture and normalization schemas, an exact state-file path, and explicit provider fallback guidance. This matches the level 5 anchor for fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

A clear sequence (preconditions → acceptance criteria → safety/lifecycle → batch or targeted start → capture → complete/abort) with explicit validation ("verifies all ARs and CDs are disabled"), fail-closed behavior ("disables all rules before returning the failure"), an abort feedback path, and an acceptance checklist. The destructive/batch cap does not apply because validation is present, matching the level 5 anchor.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear section headers and no nested references, but at ~155 lines with two sizable inline JSON schema blocks and dense qualification-batch policy, some detail could move to one-level-deep reference files. This matches level 4's good structure with minor organization gaps rather than level 5's appropriately split content.

4 / 5

Total

19

/

20

Passed

Description

57%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, correctly using third-person voice, but it answers only "what" — the "when" is absent and natural trigger phrases are thin. Adding an explicit "Use when..." clause and common user phrasings would substantially improve it.

Suggestions

Add an explicit trigger clause, e.g. "Use when a Sentinel Analytic Rule has been migrated to a Defender XDR Custom Detection and alert parity must be confirmed before sign-off."

Include natural user phrasings like "compare alerts", "validate the migration", or "confirm the converted detection matches" alongside the platform-specific terms.

Briefly enumerate what parity validation covers (alert counts, severity, tactics, entities, evidence) so the capability scope is explicit rather than implied by "parity validation".

DimensionReasoningScore

Specificity

Names the domain and one concrete action ("Perform strict lab-only parity validation between a Microsoft Sentinel Analytic Rule and its migrated Defender XDR Custom Detection") but does not enumerate what parity validation covers (alert counts, severity, entities, evidence). This matches the anchor for naming the domain with 1-2 concrete actions, below the several-actions coverage of level 4.

3 / 5

Completeness

The "what" is clear (strict lab-only parity validation between an Analytic Rule and its migrated Custom Detection) but there is no "Use when..." clause or equivalent explicit trigger guidance; "lab-only" is a constraint, not a trigger, and "migrated" only weakly implies when. Per the guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Sentinel", "Defender XDR", "Analytic Rule", "Custom Detection", "parity") but natural phrasings a user would say are missing ("compare alerts", "validate the migration", "after migrating detections"). Some relevant keywords with missing variations matches level 3 rather than level 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (Sentinel Analytic Rule to Defender XDR Custom Detection parity after migration) with distinct trigger terms, so overlap with other skills is minimal. This clearly matches the level 5 anchor for a clear niche with distinct triggers.

5 / 5

Total

14

/

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-alert-parity-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.