Agent skill

Dt Migration

by Dynatrace in Dynatrace/dynatrace-for-ai

Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents.

Apache-2.0Auto-check passed

Install Dt Migration

skills CLI
$ npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Dynatrace/dynatrace-for-ai dt-migration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Dynatrace/dynatrace-for-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dt-migration .claude/skills/dt-migration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dt-migration
GitHub stars
163
Token cost
~2.4k tokens
SKILL.md length
864 words
Files
18 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents.

  • Works in 7 steps: Identify the classic input pattern → Identify the involved classic entity… → Look up the Smartscape replacement in… → …
  • SKILL.md covers Query Purpose Classification, Migration Workflow, Core Entity Mapping Table and DQL Constructs to Inspect…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dt Migration is an agent skill from Dynatrace/dynatrace-for-ai. Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents. Covers three scenarios. (1) mass data queries filtered by classic entity conditions — migrate to direct dimension filters first, Smartscape only as fallback; (2) mass data queries using entity subqueries for filtering — same dimension-first strategy; (3) pure entity list queries — migrate fetch dt.entity. to smartscapeNodes. Also handles entityName, entityAttr, classicEntitySelector, and classic relationship patterns.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including reference files (for example `references/README.md`, `references/auto-tagging-field-mapping.md` and `references/dql-function-migration.md`).

The repository describes itself as: Skills, prompts, and instructions for building AI agents on top of Dynatrace production context. The licence is Apache-2.0.

Example prompts

  • “/dt-migration”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Identify the classic input pattern
  2. Identify the involved classic entity types.
  3. Look up the Smartscape replacement in the core entity mapping table below.
  4. Check which classic DQL constructs need explicit migration.
  5. Rewrite the query using Smartscape primitives
  6. Check for special cases, unsupported entities, or ID assumptions.
  7. Load the matching detailed references for the specific entity family or migration pattern.

What it can do on your machine

Read from SKILL.md and the folder at commit 4f9aa71. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dt Migration loads about 2.4k tokens when it runs, and up to ~32k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 864 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~129
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~32k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Dynatrace/dynatrace-for-ai at commit 4f9aa71, republished under its Apache-2.0 licence (© Dynatrace). 864 words, ~2,393 tokens.

Download SKILL.mdSave it as .claude/skills/dt-migration/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
dt-migration
description
Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents. Covers three scenarios. (1) mass data queries filtered by classic entity conditions — migrate to direct dimension filters first, Smartscape only as fallback; (2) mass data queries using entity subqueries for filtering — same dimension-first strategy; (3) pure entity list queries — migrate fetch dt.entity.* to smartscapeNodes. Also handles entityName, entityAttr, classicEntitySelector, and classic relationship patterns.
license
Apache-2.0

Smartscape Migration Skill

This skill migrates Dynatrace classic and Gen2 entity-based DQL queries and query patterns to Smartscape-based equivalents.

Load the dt-dql-essentials skill before writing final DQL so the translated query also follows current DQL syntax rules.

This skill focuses on Smartscape-oriented DQL migration only. It does not cover asset-level migration workflows.

Query Purpose Classification

Start here. The correct migration strategy depends on what the query is actually trying to do — not just which classic constructs it uses.

There are three distinct situations:

#SituationClassic anti-patternMigration strategy
1Mass data query filtered by entity conditionsclassicEntitySelector(...) inline in filter: of a timeseries, logs, or metrics queryResolve entity conditions to raw data dimensions first. Smartscape is a fallback, not the default.
2Mass data query using entity subquery for filteringfetch dt.entity.* inside in [...], lookup [...], or join [...] to filter the outer mass data querySame dimension-first strategy. Rewrite as raw dimension filter or in [smartscapeNodes ...] subquery.
3Pure entity list queryfetch dt.entity.* used standalone or as the primary result sourcesmartscapeNodes is the only valid path. No raw dimension alternative exists.

Decision:

  • Situations 1 or 2 — load references/mass-data-filtering-strategy.md and complete all steps including field discovery (Step 2) and equivalence verification (Step 4). Do not skip the fieldsSnapshot gates — they determine which approach is viable. Only fall back to the Migration Workflow below when the entity-type mapping or relationship traversal is needed to complete a Smartscape subquery.
  • Situation 3 — continue with the Migration Workflow and entity mapping table below.

Note: Situation 3 has a sub-case where classicEntitySelector is used to filter the entities returned by fetch dt.entity.*. This is rare and follows the same smartscapeNodes path — resolve the selector conditions using references/mass-data-filtering-strategy.md Step 1B, then apply them as node filters in smartscapeNodes.

Migration Workflow

Follow this order for Situation 3 (pure entity list queries) and for constructing Smartscape subqueries in Situations 1 and 2:

  1. Identify the classic input pattern:
    • fetch dt.entity.*
    • classicEntitySelector(...)
    • relationship field access such as belongs_to[...], runs[...], instance_of[...]
    • signal or event queries using dt.entity.*
  2. Identify the involved classic entity types.
  3. Look up the Smartscape replacement in the core entity mapping table below.
  4. Check which classic DQL constructs need explicit migration.
  5. Rewrite the query using Smartscape primitives:
    • smartscapeNodes
    • smartscapeEdges
    • traverse
    • references
    • getNodeName()
    • getNodeField()
  6. Check for special cases, unsupported entities, or ID assumptions.
  7. Load the matching detailed references for the specific entity family or migration pattern.

For the full migration process and output expectations, load references/migration-workflow.md.

Core Entity Mapping Table

Use this compact table first for common migrations. For the full mapping set, load references/type-mappings.md.

Classic / Gen2 entitySmartscape fieldSmartscape node typeNotes
dt.entity.hostdt.smartscape.hostHOSTStandard host mapping
dt.entity.servicedt.smartscape.serviceSERVICEStandard service mapping
dt.entity.process_group_instancedt.smartscape.processPROCESSProcess instance maps directly
dt.entity.container_group_instancedt.smartscape.containerCONTAINERContainer-group instance maps directly
dt.entity.kubernetes_clusterdt.smartscape.k8s_clusterK8S_CLUSTERKubernetes cluster
dt.entity.kubernetes_nodedt.smartscape.k8s_nodeK8S_NODEKubernetes node
dt.entity.kubernetes_servicedt.smartscape.k8s_serviceK8S_SERVICEKubernetes service
dt.entity.cloud_applicationmultiple workload fieldsmultiple K8S workload node typesMaps to multiple workload types; load the cloud-application guide
dt.entity.cloud_application_instancedt.smartscape.k8s_podK8S_PODClassic cloud app instance becomes pod
dt.entity.cloud_application_namespacedt.smartscape.k8s_namespaceK8S_NAMESPACENamespace mapping
dt.entity.applicationdt.smartscape.frontendFRONTENDFrontend application mapping
dt.entity.aws_lambda_functiondt.smartscape.aws.lambda_functionAWS_LAMBDA_FUNCTIONCloud-function entity mapping
Show full SKILL.md (337 more words)Show less

DQL Constructs to Inspect During Migration

These classic constructs usually need explicit rewriting:

Classic constructTypical Smartscape replacementNotes
entityName(x)name or getNodeName(x)Prefer name when querying nodes directly
entityAttr(x, "...")direct node field or getNodeField(x, "...")Prefer direct fields when available
classicEntitySelector(...)node filters plus traverseStart from the constrained side; for mass data queries see mass-data-filtering-strategy.md first
dt.entity.* in signal queriesdt.smartscape.*Applies to by, filter, fieldsAdd, expand, and related clauses
belongs_to[...], runs[...], instance_of[...]traverse or references[...]references works only for static edges
classic entity ID filtersSmartscape idDo not reuse classic IDs blindly
affected_entity_ids and affected_entity_typessmartscape.affected_entitiesOne record array replaces the two parallel arrays; each record has id, type, and name

For the detailed function-by-function guide, load references/dql-function-migration.md.

Special Cases

Do not translate these patterns literally:

  • Host group — no standalone Smartscape entity; use fields on HOST
  • Process group — no standalone Smartscape entity; use fields on PROCESS
  • Container group — no standalone Smartscape entity; preserve output shape with placeholders if needed
  • Classic IDs — classic entity IDs do not carry over to Smartscape automatically
  • Planned, missing, or not-planned mappings — check the full mapping table before assuming direct support

Load references/special-cases.md before migrating these patterns.

Entity-Focused Guides

When a migration centers on a specific entity family, load the matching detailed guide:

Each guide explains:

  • what the classic entity represented
  • what the Smartscape replacement is
  • which fields usually change
  • how relationships are migrated
  • common examples and pitfalls

References

© Dynatrace, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (references) in skills/dt-migration of Dynatrace/dynatrace-for-ai.

  • SKILL.md
  • references/README.md
  • references/auto-tagging-field-mapping.md
  • references/dql-function-migration.md
  • references/entity-cloud-application.md
  • references/entity-container.md
  • references/entity-host.md
  • references/entity-kubernetes.md
  • references/entity-process.md
  • references/entity-selector-predicates.md
  • references/entity-service.md
  • references/examples.md
  • references/mass-data-filtering-strategy.md
  • references/migration-workflow.md
  • references/quick-reference.md
  • references/relationship-mappings.md
  • references/special-cases.md
  • references/type-mappings.md

Open the folder on GitHubat commit 4f9aa71

Compare with similar skills

Dt Migration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dt Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dt Migration this skillDynatrace/dynatrace-for-ai163—~2.4kAutomated safety check: PassApache-2.0
Reversible MigrationJuliusBrussee/caveman111k1 repos~196Automated safety check: PassApache-2.0
Database Migrationsaffaan-m/ECC276k4 repos~3kAutomated safety check: PassMIT
Database Migrationsaffaan-m/ECC276k1 repos~2.4kAutomated safety check: PassMIT
Safe Database Migration Patternsaffaan-m/ECC276k—~3.3kAutomated safety check: PassMIT
Migrate Createruvnet/ruflo74k—~583Automated safety check: NotesMIT

Similar skills

  • Reversible Migration

    JuliusBrussee/caveman

    Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and…

    111k GitHub starsUsed in 1 repo~196 tokens
    DevelopmentAuto-check passed
  • Safe, reversible database migration patterns: forward-only production changes, expand-contract zero-downtime renames, concurrent indexes, batched backfills, and per-tool workflows for PostgreSQL…

    276k GitHub starsUsed in 4 repos~3k tokens
    DatabasesAuto-check passed
  • Şema değişiklikleri, veri migration'ları, rollback'ler ve PostgreSQL, MySQL ve yaygın ORM'ler (Prisma, Drizzle, Django, TypeORM, golang-migrate) arasında sıfır kesinti deployment'ları için…

    276k GitHub starsUsed in 1 repo~2.4k tokens
    DatabasesAuto-check passed
  • Rules and examples for safe, reversible schema changes in production: zero-downtime column and index changes, large data backfills and ORM migration workflows.

    276k GitHub stars~3.3k tokensUpdated today
    DatabasesAuto-check passed
  • Migrate Create

    ruvnet/ruflo

    Create a new sequentially numbered database migration with up/down SQL files

    74k GitHub stars~583 tokensUpdated today
    DatabasesAuto-check: notes
  • Migration

    kortix-ai/suna

    How to change the database schema in this repo. An agent skill from kortix-ai/suna.

    20k GitHub stars~1.2k tokensUpdated today
    DatabasesAuto-check passed

More from Dynatrace/dynatrace-for-ai

All 33 skills in this repo
  • Dt Obs Analytics

    Dynatrace/dynatrace-for-ai

    Analyze dashboards and notebooks using Davis analyzers — anomaly detection, novelty scoring, and correlation.

    163 GitHub stars~3.9k tokensUpdated 8 days ago
    Auto-check passed
  • Dt Setup iOS

    Dynatrace/dynatrace-for-ai

    Set up the Dynatrace iOS SDK (OneAgent) in an iOS project using Swift Package Manager.

    163 GitHub stars~3.3k tokensUpdated 8 days ago
    Auto-check passed
  • Dt Alerting

    Dynatrace/dynatrace-for-ai

    End-to-end Dynatrace alerting lifecycle — anomaly detector setup and model selection (static threshold, adaptive baseline, seasonal baseline), alert event storage in Grail, problem grouping and…

    163 GitHub stars~3.3k tokensUpdated 8 days ago
    Auto-check passed
  • Dt Obs AWS

    Dynatrace/dynatrace-for-ai

    AWS cloud resource monitoring including EC2, RDS, Lambda, ECS/EKS, VPC networking, load balancers, S3, DynamoDB, SQS/SNS, and cost optimization.

    163 GitHub stars~4.2k tokensUpdated 8 days ago
    Auto-check passed
  • Dt Obs Ext Monitors

    Dynatrace/dynatrace-for-ai

    3rd-party test and monitor result ingestion into Dynatrace Grail via the platform events ingest API (platform/ingest/custom/events/).

    163 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check passed
  • Dt Obs Problems

    Dynatrace/dynatrace-for-ai

    DAVIS problem analysis including root cause identification, impact assessment, and correlation with other telemetry.

    163 GitHub stars~4.6k tokensUpdated 8 days ago
    Auto-check passed

Questions about Dt Migration

What does Dt Migration do?

Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents. Dt Migration is an agent skill from Dynatrace/dynatrace-for-ai. Migrate Dynatrace classic and Gen2 entity-based DQL to Smartscape equivalents.

How do I install Dt Migration in Claude Code?

Run `npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a claude-code`. Or copy the skill folder (skills/dt-migration in Dynatrace/dynatrace-for-ai) into .claude/skills/dt-migration in your project. Claude Code loads it when a task matches its description.

How do I install Dt Migration in Codex?

Run `npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a codex`. Or copy the skill folder (skills/dt-migration in Dynatrace/dynatrace-for-ai) into .agents/skills/dt-migration in your project. Codex loads it when a task matches its description.

Can I use Dt Migration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Dynatrace/dynatrace-for-ai --skill dt-migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dt-migration, .gemini/skills/dt-migration, .github/skills/dt-migration and .opencode/skills/dt-migration in your project.

What does Dt Migration need to run?

SKILL.md names no scripts, command-line tools or credentials: Dt Migration is instructions for the agent only.

Does Dt Migration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dt Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dt Migration use?

Dt Migration is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dt Migration use?

About 2.4k tokens (SKILL.md is roughly 9.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 29k tokens, read only when the agent opens those files.

What are the alternatives to Dt Migration?

Skills that share tags, products or a category with Dt Migration: Reversible Migration (JuliusBrussee/caveman, 111k stars), Database Migrations (affaan-m/ECC, 276k stars), Database Migrations (affaan-m/ECC, 276k stars) and Safe Database Migration Patterns (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dt Migration?

Dynatrace (a GitHub organization) maintains it in Dynatrace/dynatrace-for-ai, which has 163 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 1, 2026.

Source: Dynatrace/dynatrace-for-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.