CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

asim-parser-create-parser

This starts the process of creating a new ASIM schema parser by generating the initial version of the parser based on the requirements gathered. Use this skill when you have gathered all necessary information for the new ASIM parser and are ready to create the initial version of the parser.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/asim-parser-create-parser/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 tight, expert-level procedural document: a prerequisite checklist, four clearly ordered steps with concrete KQL queries, explicit prohibited patterns, a ranked operator reference, and a final save-and-verify checkpoint. Its only notable gaps are the absence of a fix-and-retry loop around verification and the lack of an assembled function skeleton for the parameter conventions.

DimensionReasoningScore

Conciseness

The body is directive and assumes KQL/ASIM knowledge ('Filter → Parse → Map', operator ranking, prohibited patterns) with no concept tutorials. Minor over-explanation remains — 'This step is crucial to validate that the parser is correctly formed and will function as expected when deployed' and the 'map as many fields as possible' guidance appearing in both Step 2 and Step 3 — so it fits anchor 4 rather than 5, and is well above 3 since padding is incidental.

4 / 5

Actionability

Concrete, executable guidance throughout: exact queries ('<tableName> | getschema', '| count', '| take <minimum of rows found or 2000>'), a canonical file name example ('ASimNetworkSessionCiscoASA.kql'), a runnable KQL snippet for placeholder fields, and a ranked operator table. It is not a 5 because the 'disabled'/'pack' parameter guidance and the '| where not(disabled)' filter are described but never shown assembled in a function skeleton, leaving minor gaps.

4 / 5

Workflow Clarity

A clear prerequisite checklist feeds a sequenced Step 1-4 flow ending in an explicit validation checkpoint: 'Verify the KQL query runs without syntax errors by using the log-analytics-workspace-queryer skill'. Not a 5 because there is no error-recovery loop (fix and re-run) after the verification step; not a 3 because the sequence and its checkpoint are explicit and the operation is non-destructive, so the validation cap does not apply.

4 / 5

Progressive Disclosure

No bundle files exist, and the body is a single well-sectioned document (~93 lines) whose detailed material is appropriately delegated to external sources (ASimTester.csv for field classifications, Learn Microsoft docs for schema details and parser development). Fits anchor 4: good structure and mostly appropriate placement; not a 5 because the ~30-line prohibited-patterns and required-columns reference material could live in a bundled reference file to keep SKILL.md a leaner overview.

4 / 5

Total

16

/

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 communicates its niche (initial ASIM parser creation) and includes an explicit use-when clause, giving it strong distinctiveness and completeness. Its weaknesses are thin capability coverage (one action, restated) and narrow trigger terms, plus a second-person phrasing that the rubric penalizes.

Suggestions

State the concrete capabilities in third person, e.g. 'Creates the initial version of a new ASIM schema parser: samples source data, maps source columns to the target ASIM schema, and saves a validated .kql function' — this fixes both the second-person penalty and the single-action coverage.

Broaden trigger terms to include the natural phrases a user would say, such as 'KQL parser', 'Sentinel normalization', 'build/create an ASIM parser', and 'map source logs to an ASIM schema'.

Make the 'when' clause trigger-phrase based rather than state based, e.g. 'Use when the user asks to create, build, or generate an ASIM parser and the source table and target schema are known.'

DimensionReasoningScore

Specificity

The description names the domain ('creating a new ASIM schema parser') but offers essentially one action, 'generating the initial version of the parser based on the requirements gathered', which restates the opening clause. Base fit was anchor 3 (domain plus 1-2 concrete actions, not comprehensive), reduced by 1 per the rubric's second-person penalty for 'Use this skill when you have gathered'.

2 / 5

Completeness

Both parts are present: 'what' ('creating a new ASIM schema parser by generating the initial version of the parser') and an explicit 'Use this skill when you have gathered all necessary information… and are ready to create the initial version'. It is not a 5 because the 'when' is a state description rather than concrete trigger phrases a user would say; it is above 3 because the 'when' clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Relevant keywords exist ('ASIM schema parser', 'ASIM parser') but coverage stops there; natural variations users might say — 'KQL function', 'Sentinel', 'normalization parser', 'build a parser' — are missing. Fits anchor 3 rather than 4 because synonym coverage is thin, and not 2 because the terms present are specific and natural to the domain.

3 / 5

Distinctiveness Conflict Risk

'ASIM schema parser' is a clear niche with minimal overlap risk, and 'generating the initial version' further distinguishes it from parser-refinement or deployment skills. Matches anchor 5 (clear niche with distinct triggers) and is not a 4 since no closely related skill would plausibly be triggered by these terms.

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