CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

asim-parser-validator

This skill will validate an ASIM by checking the schema output of the parser and also checking the data that the parser represents in the columns. Use this skill after you have created or updated an ASIM parser to validate that the parser is correctly mapping the source data to the ASIM schema.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

A strong, actionable skill body: concrete commands, a clear validated sequence with feedback loops, and well-organized single-file structure. Remaining improvements are small — defining the location deployment parameter and showing sample tester output.

Suggestions

Add the workspace region/location to the Inputs section, since the ARM deployment command requires a '<location>' parameter that is never specified.

Show a short example of actual ASimSchemaTester/ASimDataTester output rows so the agent can recognize the (0)/(1)/(2) severity format when it appears.

Make the fix loop explicit: state that after applying fixes, the affected validation query should be re-run until no Error-level (0) results remain, rather than only re-running the bare parser in Step 3.

DimensionReasoningScore

Conciseness

The body is efficient and sticks to non-obvious, domain-specific content (ASim tester functions, ARM template URLs, severity levels); nothing explains concepts Claude already knows. Minor trimmable padding exists (the rationale for '| limit 1000' and "After successful deployment, the functions are available in the workspace"), so it fits the 4 anchor rather than the fully lean 5 anchor.

4 / 5

Actionability

Guidance is mostly executable: concrete az-CLI commands for saved-search discovery and ARM deployment, real template URLs, and parameterized KQL queries ('| getschema | invoke ASimSchemaTester("<name>")'). Minor gaps keep it at 4: the '<location>' deployment parameter is never defined in the Inputs section, and no sample tester output is shown so the agent knows what the results look like.

4 / 5

Workflow Clarity

The sequence is explicit (Step 0 deployment check with a conditional branch, Step 1 schema validation, Step 2 data validation, Step 3 re-run) with explicit checkpoints and feedback loops: "Address all errors before proceeding to Step 2" and "If the query fails with a syntax error, fix the issue before returning results". This matches the 5 anchor's explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

The skill is a single, well-sectioned SKILL.md (~96 lines) with no bundle directories needed; everything is appropriately placed in one file and navigation via clear section headers is easy. External materials (ARM templates) are referenced by URL instead of being inlined, so it satisfies the well-organized, nothing-to-split case rather than the 4 anchor's organization gaps.

5 / 5

Total

18

/

20

Passed

Description

82%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 well-formed description with an explicit what-and-when structure and a distinct niche. Its main weaknesses are the awkward clause "the data that the parser represents in the columns", second-person voice in the trigger clause, and missing common synonyms (test, KQL, Sentinel).

Suggestions

Rewrite the awkward phrase "checking the data that the parser represents in the columns" as a concrete action, e.g., "validating that column values are correctly mapped, normalized, and formatted (e.g., IP addresses, enumerations)".

Use third person throughout, e.g., "Use after creating or updating an ASIM parser" instead of "after you have created or updated an ASIM parser".

Add natural synonyms to broaden triggering, e.g., "test an ASIM parser", "KQL parser", or "Microsoft Sentinel ASIM normalization".

DimensionReasoningScore

Specificity

The description names the domain (ASIM parser validation) and two concrete actions — "checking the schema output of the parser" and "checking the data that the parser represents in the columns" — but coverage is not comprehensive (no mention of result interpretation or the fix loop). It would rate a 4 on actions alone, but the second-person phrasing "after you have created" triggers the rubric's 1-point voice penalty, landing it at 3 rather than 4.

3 / 5

Completeness

It explicitly answers both questions: the "what" is "validate an ASIM by checking the schema output... and also checking the data... in the columns", and the "when" is the concrete trigger clause "Use this skill after you have created or updated an ASIM parser". This matches the 5 anchor's pattern of clear what plus explicit concrete trigger; the 4 anchor's weaker/implicit 'when' does not fit.

5 / 5

Trigger Term Quality

Natural domain terms are present — "validate an ASIM", "created or updated an ASIM parser", "schema", "mapping the source data" — which a Sentinel/ASIM practitioner would actually say. A few natural variants are missing ("test the parser", "KQL", "Microsoft Sentinel"), so it sits at 4 rather than 5, and it is well above the generic-keyword level of 3.

4 / 5

Distinctiveness Conflict Risk

"ASIM" is a highly specific niche term and the triggers (parser validation, ASIM schema mapping) are distinct, so it is unlikely to fire for unrelated skills. It matches the 'clear niche with distinct triggers; minimal conflict risk' anchor rather than the 4 anchor, which requires overlap with closely related skills.

5 / 5

Total

17

/

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/asim-parser-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.