CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sentinel-xdr-migration-orchestrator

Orchestrate conversion of a Microsoft Sentinel solution into Defender XDR Custom Detection YAML by using repository utilities and available runtime providers.

Quality

78%

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-migration-orchestrator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 a lean, directive workflow with concrete CLI commands, explicit conditional logic, named fallback providers, and a terminal readiness checklist, delegating detail appropriately to its two required skills. The only notable gaps are a couple of steps lacking a concrete method and the absence of an explicit fix-and-revalidate loop for needsReview findings.

DimensionReasoningScore

Conciseness

The body is pure directive content — commands like `python -m pip install -e Tools\SentinelToXDRMigration` and terse numbered steps — with no explanations of concepts Claude already knows; even rationale sentences ("MCP authentication belongs to the agent host rather than the Python CLI") convey non-obvious domain knowledge. Nothing reads as padding, matching the lean 5 anchor rather than 4's "minor instances of over-explanation".

5 / 5

Actionability

Concrete, executable commands are given for install, `sentinel-xdr-migration doctor`, and `setup --non-interactive`, and specific providers are named (Triage MCP, `RunAdvancedHuntingQuery`, Log Analytics CLI/API, Graph CLI) with explicit fallback conditions. It is below 5 because steps like "Confirm the solution path" and "Inspect the official Triage MCP capabilities" give no concrete method or command, and above 3 because the guidance is genuinely executable rather than pseudocode.

4 / 5

Workflow Clarity

The 10-step sequence is clearly ordered with explicit conditionals ("If `firstRun` is true", "if authentication is declined"), validation gates (doctor, reviewing every `needsReview` result, runtime execution on both platforms), and a terminal XDR-ready checklist. It falls short of 5 because there is no fix-and-revalidate feedback loop for `needsReview` items or conversion errors — step 8 gates ("Never present it as XDR-ready") but never says how to resolve them — and stays above 3 because validation checkpoints are explicit rather than absent.

4 / 5

Progressive Disclosure

This is a compact, self-contained orchestrator (~55 lines) with clear `## Scope` and `## Workflow` sections, nothing inlined that belongs in a separate file, and no bundle files to reference; detailed work is delegated to the clearly named required skills `sentinel-xdr-rule-converter` and `sentinel-xdr-detection-validator`. Navigation is trivial and all content is appropriately placed, matching the 5 anchor for a short skill with no need for external references.

5 / 5

Total

18

/

20

Passed

Description

61%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 clearly states what the skill does — orchestrating conversion of Microsoft Sentinel solutions into Defender XDR Custom Detection YAML — using the domain's natural product-name terms. However, it omits any 'when to use' trigger guidance, leans on the vague qualifier 'repository utilities and available runtime providers' instead of enumerating concrete capabilities, and reads close to the sibling converter skill's role.

Suggestions

Add an explicit trigger clause, e.g. "Use when migrating a Microsoft Sentinel solution or its analytic rules to Microsoft Defender XDR Custom Detections."

Replace "by using repository utilities and available runtime providers" with the concrete capabilities: converting rules, validating YAML, executing Sentinel and Advanced Hunting queries, and reporting provenance and parity gaps.

Include natural synonyms users would say — "migrate/migration", "KQL", "analytic rules" — alongside the product names to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Orchestrate conversion of a Microsoft Sentinel solution into Defender XDR Custom Detection YAML" names the domain plus one concrete action, but the qualifier "by using repository utilities and available runtime providers" is generic and the description's other real capabilities (doctor/setup, validation, execution reporting) are absent. It is above a score of 2 because the domain and action are concrete rather than minimal, but below 4 because only one specific action is listed with generic supporting language.

3 / 5

Completeness

The "what" is clear (orchestrate Sentinel-to-XDR detection conversion), but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the rubric. It is not 4 because the "when" is wholly absent rather than merely implicit, and not 2 because the "what" half is concrete.

3 / 5

Trigger Term Quality

The product names "Microsoft Sentinel", "Defender XDR", and "Custom Detection YAML" are the natural phrases a user would say when needing this skill. It falls short of 5 because common variations such as "migrate/migration", "KQL", and "analytic rules" are missing, and above 3 because the primary natural terms for this domain are present rather than generic.

4 / 5

Distinctiveness Conflict Risk

The Sentinel-to-Defender-XDR niche is highly specific with minimal conflict against unrelated skills, but "conversion of a Microsoft Sentinel solution into Defender XDR Custom Detection YAML" also describes the sibling `sentinel-xdr-rule-converter` skill's job; only the word "Orchestrate" signals this skill's coordination role. Minor overlap risk with a closely related skill matches the 4 anchor rather than 5's "clear niche with distinct triggers".

4 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

Azure/Azure-Sentinel

Path

.github/skills/sentinel-xdr-migration-orchestrator/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.