CtrlK
BlogDocsLog inGet started
Tessl Logo

dt-dql-essentials

REQUIRED before generating any DQL queries. Provides critical syntax rules, common pitfalls, and patterns. Load this skill BEFORE writing DQL to avoid syntax errors.

72

1.40x
Quality

56%

Does it follow best practices?

Impact

100%

1.40x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/dt-dql-essentials/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 functions more as a procedural instruction ('load this before doing X') than a proper skill description. It lacks concrete actions, specific capabilities, and natural trigger terms beyond 'DQL'. While it establishes a narrow domain (DQL queries), it fails to articulate what the skill actually does or provide sufficient trigger guidance for reliable selection.

Suggestions

Replace the imperative meta-instruction tone with concrete capability statements, e.g., 'Provides DQL (Dynatrace Query Language) syntax reference including fetch commands, filtering, aggregation functions, and parsing expressions.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when writing DQL queries, Dynatrace Query Language, log analysis queries, metric queries, or when encountering DQL syntax errors.'

List specific patterns or pitfalls covered to distinguish from other potential DQL-related skills, e.g., 'Covers common mistakes with pipe syntax, timeseries aggregation, and field extraction.'

DimensionReasoningScore

Specificity

The description does not list any concrete actions or capabilities. It mentions 'syntax rules, common pitfalls, and patterns' but these are abstract categories, not specific actions like 'validates queries' or 'generates JOIN clauses'. It reads more like a meta-instruction than a capability description.

1 / 3

Completeness

The 'when' is partially addressed ('BEFORE writing DQL', 'before generating any DQL queries'), but the 'what' is weak — it says it 'provides critical syntax rules, common pitfalls, and patterns' without specifying what those are or what concrete outputs the skill enables. There is no explicit 'Use when...' clause with trigger scenarios.

2 / 3

Trigger Term Quality

It includes 'DQL' and 'DQL queries' which are relevant trigger terms, but lacks natural variations users might say (e.g., 'Dynatrace Query Language', 'USQL', 'Dynatrace metrics', 'log queries'). The term 'syntax errors' is somewhat useful but the coverage is limited.

2 / 3

Distinctiveness Conflict Risk

The mention of 'DQL' provides some specificity to a niche domain, but the description is vague enough that it could overlap with any DQL-related skill (e.g., a DQL tutorial skill, a DQL debugging skill, a DQL reference skill). The lack of concrete capability differentiation increases conflict risk.

2 / 3

Total

7

/

12

Passed

Implementation

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-structured DQL reference skill with excellent actionability — the syntax pitfalls table alone is highly valuable and the concrete examples throughout are copy-paste ready. Progressive disclosure is well-handled with clear references to deeper materials. The main weakness is some content repetition (reference lists, metric fetch warnings) that inflates token usage, and the lack of an explicit query-building workflow with validation steps.

Suggestions

Consolidate the duplicated reference listings — the 'Use Cases' table, 'DQL Reference Index', and 'References' section at the bottom all point to the same files. A single well-organized reference section would save significant tokens.

Remove the duplicate 'no fetch dt.metric' warning that appears in both the 'Fetch Command → Data Model' section and the 'Metric Discovery' section.

Add a brief query-building workflow with validation steps (e.g., 1. Identify data object → 2. Check available fields → 3. Write query → 4. Verify results aren't empty → 5. Refine filters).

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining basic concepts Claude would know, but there is significant repetition — the reference index is duplicated in both the 'Use Cases' table and the 'References' section at the bottom, data objects are listed twice (Fetch Command table and Data Objects section), and the metric discovery note ('no fetch dt.metric') appears twice. Some sections like 'Modifying Time' include rules Claude likely already knows (timestamp arithmetic). However, the pitfalls table and entity field patterns earn their tokens.

2 / 3

Actionability

The skill provides highly concrete, executable DQL snippets throughout — the syntax pitfalls table with wrong/right columns is immediately actionable, the chained lookup pattern includes a complete working example with comments, makeTimeseries examples are copy-paste ready, and metric discovery has a working query. Named parameters, backtick requirements, and field naming conventions are all specific and directly usable.

3 / 3

Workflow Clarity

The chained lookup pattern demonstrates a clear multi-step workflow with explicit sequencing and explains what goes wrong without the intermediate step. However, there's no overarching workflow for 'how to write a DQL query' (e.g., discover data object → check fields → write query → validate results). The skill is more of a reference than a guided workflow, and there are no validation/verification checkpoints for query correctness.

2 / 3

Progressive Disclosure

The skill provides an excellent overview with well-organized sections and clear one-level-deep references to detailed materials (semantic dictionary, smartscape navigation, operators, optimization, formal DQL spec). The reference index table is comprehensive and well-signaled, and inline references like '→ Full formal parameter specification: references/dql/dql-commands.md' guide the reader to deeper content without cluttering the main document.

3 / 3

Total

10

/

12

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.

Validation11 / 11 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.