CtrlK
BlogDocsLog inGet started
Tessl Logo

dt-sec-semantic-mapping

Suggest and validate semantic dictionary (SD) mappings for new security integrations using vendor API samples or live events. Use when: mapping a new security vendor data to Dynatrace SD; checking required fields; validating namespaces; highlighting discrepancies vs the semantic dictionary; proposing mapping improvements; running runtime validation against live tenant data.

68

Quality

83%

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

73%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 well-structured orchestration SKILL.md that stays lean and delegates detail cleanly, with strong workflow gating and error paths. Its weaknesses are a referenced `samples/` directory that is missing from the bundle, an unnamed external-skill reference, and redundant cataloging of the same reference files across three sections.

Suggestions

Create the `samples/` directory (or remove/repair the citation in the Baseline Sources section) so the bundle matches what the body references.

Replace the vague pointer "A skill covering full SD access patterns and Grail-table documentation" with the actual skill name or a concrete link so the reference is navigable.

Consolidate the duplicate file annotations in "Baseline Sources", "Workflows", and "References" into a single annotated reference list to cut repetition and tighten token usage.

DimensionReasoningScore

Conciseness

Prose style is lean and assumes Claude's competence (no concept explanations), but the same reference files are described with overlapping summaries in three separate sections — "Baseline Sources", "Workflows", and "References" (e.g., `references/validation-policy-and-reporting.md` is annotated three times). This repeated cataloging is more than the "minor instances that could be trimmed" of the level-4 anchor, though it is not padded explanation either, so it sits at the mostly-efficient-but-tightenable anchor.

3 / 5

Actionability

As an instruction-only orchestration skill, the body gives mostly executable routing: a mandatory intake gate ("Always run the intake checklist in `references/intake-and-constraints.md` before generating or validating a mapping"), a mode-detection table mapping each input shape to a named workflow and its procedural source, and a concrete phase sequence ("Phase 1 mapping table → user approval → Phase 2 sample JSON"). The gap is that every actual procedure, rule, and template is delegated to reference files — appropriate for this skill's design, but the body itself carries no concrete example of a mapping table or output snippet, leaving minor gaps against the fully-executable anchor.

4 / 5

Workflow Clarity

The three workflows are clearly sequenced and gated: intake checklist first, mode detection from input shape, a user-approval checkpoint in Workflow A, explicit handling when inputs are incomplete ("continue with a partial draft but explicitly list missing evidence and confidence limits"), and an error-recovery path for the common misclassification (the "alternative-classification path when a detection-class mapping incorrectly emits `*_SCAN` events"). Validation is the skill's core purpose (Workflows B1/B2), and the required Step 0 for B2 is stated explicitly — this matches the anchor for clear sequence, explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Structure is genuinely good: an ~80-line overview with well-signaled, one-level-deep references, each annotated with what it contains, plus an anchored deep link ("§ Event-Type Coverage"). Two organization gaps keep it below the top anchor: the body cites a `samples/` directory that does not exist in the bundle, and one "Reference" is an unnamed pointer to an external skill ("A skill covering full SD access patterns and Grail-table documentation") with no name or path, which is not navigable. Combined with the redundant re-listing of the same files across sections, this fits the good-structure-with-minor-gaps anchor rather than the easy-navigation anchor.

4 / 5

Total

16

/

20

Passed

Description

92%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 strong description: explicit what-and-when structure, third-person voice, multiple concrete actions, and a clearly demarcated niche. The only weakness is trigger-term coverage stopping just short of natural synonyms and plain-language variants of the domain jargon.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Suggest and validate semantic dictionary (SD) mappings", "checking required fields", "validating namespaces", "highlighting discrepancies", "proposing mapping improvements", "running runtime validation against live tenant data" — covering the full capability set comprehensively. It matches the anchor for multiple specific concrete actions with comprehensive coverage, not the level-4 anchor which implies minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the opening sentence ("Suggest and validate semantic dictionary (SD) mappings for new security integrations using vendor API samples or live events") and the "when" is an explicit "Use when:" clause with five concrete trigger phrases. This mirrors the top anchor exactly; the level-4 anchor's "'when' could be more explicit" does not apply.

5 / 5

Trigger Term Quality

Good keyword coverage with natural domain phrases users would say: "mapping a new security vendor data to Dynatrace SD", "checking required fields", "highlighting discrepancies". Missing common synonyms a user might naturally say — e.g., "security.events", "Grail", "OpenPipeline", or a plain-language variant of "semantic dictionary" beyond the abbreviation "SD" — so it falls just short of the comprehensive-with-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — Dynatrace security-integration SD mapping/validation — with domain-specific triggers ("Dynatrace SD", "vendor API samples", "live tenant data") that are unlikely to fire for any other skill. No overlap risk with generic mapping or validation skills.

5 / 5

Total

19

/

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
Dynatrace/dynatrace-for-ai
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.