CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

metrics-queries

Querying OpenTelemetry metrics datasets in Honeycomb, whose rules differ from trace/event datasets: bare COUNT, RATE_SUM, RATE_AVG, RATE_MAX and CONCURRENCY are forbidden, temporal aggregation is automatic, and each metric has its own attributes. Use for gauges, counters, histograms and sums; temporal aggregation (RATE, INCREASE, SUMMARIZE, LAST); finding the metrics dataset, metric names and attributes; unexpected metrics results; infrastructure metrics (CPU, memory, disk I/O, network). Not for instrumenting metrics (use otel-instrumentation), event datasets with "metrics" in their name, or conceptual questions (use observability-fundamentals).

95

1.10x
Quality

94%

Does it follow best practices?

Impact

99%

1.10x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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, highly actionable skill body: executable query examples, discovery workflows with built-in validation, and clean one-level-deep reference splitting. The only nit is slight duplication between the body's temporal-aggregation section and its dedicated reference file, which keeps conciseness just short of lean-perfect.

DimensionReasoningScore

Conciseness

The body is dense with product-specific rules Claude cannot be assumed to know (forbidden operations, temporal aggregation defaults, histogram sub-fields) and avoids generic padding. Minor trimmable spots — the temporal aggregation function list and range_interval_seconds details partially duplicate references/temporal-aggregation.md, and the granularity section's RATE_SUM-on-event-datasets aside is tangential — fit 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place anchor at 5.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste-ready JSON query fragments (calculated fields, calculations, formulas for utilization, tail ratio, error rate), exact tool invocations with parameters (get_environment, get_dataset_columns with metric_name: "k8s.pod.memory.usage"), and decision tables for allowed vs. forbidden operations. Examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Two numbered workflows with explicit validation checkpoints ("Do not guess the dataset. Always verify via get_environment or get_dataset_columns"; "Validate before querying... confirm available attributes before adding them to filters"), plus error-recovery feedback ("Spiky-looking graphs usually mean the granularity is finer than the reporting interval") and a 6-item pitfalls checklist. Queries are read-only, so the destructive/batch cap does not apply; this matches the 5 anchor (explicit validation steps, feedback loops, checklist).

5 / 5

Progressive Disclosure

Three reference files (metric-types.md, metrics-query-examples.md, temporal-aggregation.md), all verified to exist, all one level deep, and clearly signaled both at point of need and in a consolidated Reference Files section with descriptions. Deep detail (cookbook, counter-reset internals, OTel type mapping) is appropriately deferred while decision tables stay inline, matching the 5 anchor.

5 / 5

Total

19

/

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: concrete capability statements, an explicit 'Use for' trigger list, and explicit negative scope that disambiguates neighboring skills. The only weakness is that a handful of natural synonyms users might say (system metrics, resource usage, utilization) are missing from the trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple explicit, concrete capabilities covering the whole niche — forbidden operations ("bare COUNT, RATE_SUM, RATE_AVG, RATE_MAX and CONCURRENCY are forbidden"), automatic temporal aggregation, per-metric attributes, dataset/metric/attribute discovery, and infrastructure metrics ("CPU, memory, disk I/O, network"). No coverage gaps within its domain, matching the comprehensive anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

Explicitly answers both questions: the 'what' ("Querying OpenTelemetry metrics datasets in Honeycomb... COUNT... forbidden, temporal aggregation is automatic") and the 'when' via a concrete "Use for..." trigger list plus negative scope ("Not for instrumenting metrics..."). This matches the 5 anchor with concrete trigger phrases; the when-clause is fully explicit, so 4 does not fit.

5 / 5

Trigger Term Quality

Good natural-term coverage — "gauges, counters, histograms and sums", "unexpected metrics results", "infrastructure metrics (CPU, memory, disk I/O, network)" — but a few common user phrasings like "system metrics", "resource usage", or "utilization" are absent. This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche (metrics datasets in Honeycomb) with explicit disambiguation against adjacent skills — "Not for instrumenting metrics (use otel-instrumentation), event datasets with 'metrics' in their name, or conceptual questions (use observability-fundamentals)". Minimal conflict risk, matching the 5 anchor.

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

honeycombio/agent-skill

Path

honeycomb/skills/metrics-queries/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.