CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cx-telemetry-querying

Use this skill for any question involving telemetry data: "investigate an issue", "debug a problem", "find out why something is slow", "check error rates", "analyze user behavior", "understand a production incident", "query telemetry data", "look at logs", "search logs", "find errors", "find stack traces", "filter by severity", "check traces", "examine spans", "investigate request latency", "debug service-to-service calls", "look up a trace ID", "analyze RUM data", "query rum.events", "check frontend performance", "frontend errors", "Core Web Vitals", "JavaScript exceptions", "query metrics", "check CPU usage", "run a PromQL query", "check error rate", "look up a metric", "check memory usage", "how do I write a DataPrime query", "DataPrime syntax", or wants to answer questions using observability data from logs, metrics, traces, RUM, or APM.

Quality

90%

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

85%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.

An excellent routing-oriented body: fully executable CLI guidance, a well-sequenced discovery workflow with explicit pivot loops, and clean one-level-deep progressive disclosure to real reference files. The main cost is token redundancy from restated principles, duplicated command listings, and partially repetitive examples.

Suggestions

Cut the Key Principles section or reduce it to only non-obvious items (e.g., the stderr-warnings note), since most bullets restate the Loading References, Discovery Workflow, and Fallback sections verbatim.

Trim the CLI Commands Reference table to commands not already shown in the Discovery Workflow, or replace the inline Step 2 command blocks with a pointer to the table to avoid dual maintenance.

Reduce the four Examples to two representative ones (one ambiguous-source, one clear-first-choice) since they largely restate the discovery and pivoting guidance already given.

DimensionReasoningScore

Conciseness

Mostly efficient with no beginner-concept padding, but noticeably redundant: the Key Principles section restates earlier sections ("Load references before querying", "Pivot on failure", "Discover before querying"), the CLI Commands Reference table repeats commands already shown in Discovery Workflow Step 2, and four Examples restate the same workflow. Not 4 because the duplication is more than minor trimming; not 2 because there is no concept over-explanation and every section carries some unique value.

3 / 5

Actionability

Fully executable, copy-paste-ready commands with concrete flags and patterns ("cx metrics search --name '*transaction*'", "cx search-fields 'payment_failed' -s value --dataset logs") plus specific examples covering logs, spans, metrics, and RUM cases. The only placeholder ("cx dataprime query --source rum.events '...'") defers query syntax to the referenced file, which is appropriate.

5 / 5

Workflow Clarity

The Discovery Workflow is a clear 4-step sequence with explicit conditional branches after each step ("If a matching metric is found, load ..."), a dedicated Fallback and Pivoting section with an explicit recovery loop ("Do not stop after one failed attempt. Try at least two pillars"), and codebase-validation guidance. Read-only commands need no destructive-operation validation, so no cap applies.

5 / 5

Progressive Disclosure

The body is a pure router/overview pointing to seven real, one-level-deep reference files organized in a clear pillar-based table, and all referenced paths (dataprime-reference.md, logs-querying.md, spans-querying.md, promql-guidelines.md, metrics-querying.md, rum-querying.md, rum-fields.md) exist in the bundle. Query-language detail is correctly kept out of the body.

5 / 5

Total

18

/

20

Passed

Description

91%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 with best-in-class trigger coverage that explicitly states both capability and usage conditions. Its only weaknesses are a capability statement that leans on triggers rather than describing the routing/discovery behavior, and a few broad incident phrases that slightly overlap sibling operations skills.

DimensionReasoningScore

Specificity

Names the domain (telemetry/observability querying) and lists several concrete actions — "run a PromQL query", "query rum.events", "search logs", "find stack traces", "filter by severity", "look up a trace ID" — with minor gaps (e.g., the routing/discovery capability is only implied, not stated). Not 5 because the core capability description is thinner than the trigger list; not 3 because far more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both: what — "answer questions using observability data from logs, metrics, traces, RUM, or APM" — and when — a long list of concrete trigger phrases introduced by "Use this skill for any question involving telemetry data". Matches the anchor requiring both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Comprehensive coverage of natural phrases users would actually say, including synonyms and product-specific terms: "investigate an issue", "debug a problem", "find out why something is slow", "look at logs", "Core Web Vitals", "check CPU usage", "how do I write a DataPrime query". Matches the anchor's standard of full synonym coverage.

5 / 5

Distinctiveness Conflict Risk

Clear niche (querying telemetry across logs, metrics, traces, RUM, APM) with mostly distinct triggers, but phrases like "understand a production incident" and "investigate an issue" carry minor overlap risk with sibling ops skills (e.g., case triage, incident management). Not 5 because a few broad incident/investigation phrases could pull the wrong skill in a crowded skill family.

4 / 5

Total

18

/

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

coralogix/cx-cli

Path

skills/cx-telemetry-querying/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.