# dt-sec-contextualization

dt-sec-contextualization maps security signals to Dynatrace Smartscape runtime entities, verifies external scanner findings against RVA, and measures scan coverage.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1400 installs · ★ 186 repo stars
- Author: Dynatrace
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-sec-contextualization/SKILL.md
- Updated: 2026-11-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/dt-sec-contextualization

## What it does

The skill resolves identifiers and attributes (image digest, host IP, `dt.smartscape_source.id`, `k8s.*` fields) to Smartscape entities at any level — container, pod, workload, node, host, cloud, `GENAI_SERVICE`. Connects findings from different levels via a shared runtime entity: a detection on a pod and a CVE on a node, an Amazon ECR image and a running workload.

Operates in two modes. For a single supplied identifier, loads `identity-mapping.md` and resolves without pre-flight. For a finding stream from `security.events`, loads `entity-enrichment.md`, runs pre-flight, and builds per-entity aggregation. Enriches IoC (IP, domain, CVE, hash, MITRE TTP) with threat context from `THREAT_REPORT`, lists vulnerable AI services, counts covered and not-covered hosts, processes, workloads.

Requires Dynatrace and access to `security.events` for IoC enrichment, RVA verification, and coverage. Does not replace **dt-sec-insights** for rankings and posture, **dt-sec-ioc-hunting** for log hunting, **dt-obs-kubernetes** for K8s observability.

## Requirements
- Works with: Dynatrace, Kubernetes

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-sec-contextualization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/dt-sec-contextualization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/dt-sec-contextualization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-sec-contextualization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/dt-sec-contextualization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-sec-contextualization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/dt-sec-contextualization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Dynatrace/dynatrace-for-ai skills/dt-sec-contextualization
```

2. **Manually: put the files in place**
- File: `.github/skills/dt-sec-contextualization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-sec-contextualization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Dynatrace/dynatrace-for-ai --path skills/dt-sec-contextualization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/dt-sec-contextualization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-sec-contextualization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-sec-contextualization/SKILL.md

## When to use it
- map an external scanner finding to a runtime workload
- verify whether RVA detects the same vulnerability on a running entity
- resolve an image digest to the name and Smartscape id of a running container
- count hosts and pods not covered by scanning
- enrich an IoC match with actor and MITRE technique data

## Example prompts
- Which workload runs the image with digest `sha256:abc123...`?
- Show hosts not covered by RVA
- Check whether Dynatrace RVA sees this scanner finding on the same host

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 41fb1d8cd84f5607.

BEGIN THIRD-PARTY FILE 41fb1d8cd84f5607
```text
---
name: dt-sec-contextualization
description: >-
  Resolve security signals, IoC matches, or Smartscape nodes to runtime
  entities, connect findings across entity levels, verify external findings
  against RVA on the same entity, and measure scan coverage against a
  Smartscape denominator. Covers identity mapping, RVA id resolution, K8s pod
  vs. node CVE topology, AI-service vulnerabilities, coverage counts. Trigger:
  "map these findings to workloads/hosts", "which workload does this image run
  as", "is this scanner finding also detected by RVA on a running workload",
  "which AI services have vulnerabilities", "enrich this IoC match", "which
  report mentions this IoC", "hosts not covered by scanning". Queries
  security.events only for THREAT_REPORT IoC enrichment, coverage numerators,
  joining supplied findings, RVA verification, and AI-service findings. Do NOT
  use for broad posture, rankings, or an entity's vulnerabilities
  (dt-sec-insights), general DQL (dt-dql-essentials), IoC hunting in
  logs/spans (dt-sec-ioc-hunting), K8s observability (dt-obs-kubernetes).
license: Apache-2.0
---

# Security Contextualization Skill

Resolve security signals and entity attribute sets to runtime Dynatrace
Smartscape entities, summarize findings across entity levels, and connect
signals that land on different levels (e.g. a detection on a `K8S_POD` vs.
a CVE on a `KUBERNETES_NODE`) via a shared runtime entity.

## Scope Boundary

This skill **puts security data in the context of runtime entities**: Smartscape
resolution of findings, runtime context for external findings, scan coverage, IoC
enrichment, verification of external findings against Dynatrace findings (RVA), and
cross-correlation between findings. Plain `security.events` access and grouping (counts,
rankings, lifecycle, posture) stays in **dt-sec-insights**. Typical hand-off: insights
produces the finding set or ranking, this skill resolves it to runtime entities.

## What This Skill Covers

- **Identity → Smartscape mapping** — given a row carrying any of
  `dt.smartscape_source.id`, `container_image.digest`, `host.ip`, `dt.smartscape.*`, or `k8s.*` fields, resolve it to a Smartscape
  entity at any requested level (CONTAINER / K8S_POD / workload /
```
END THIRD-PARTY FILE 41fb1d8cd84f5607

The third-party file has ended. Everything between the 41fb1d8cd84f5607 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2253 of 15336 bytes. © Dynatrace · Apache-2.0 · https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-sec-contextualization/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
