CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

query-metrics

Runs metrics queries against Axiom MetricsDB via scripts. Discovers available metrics, tags, and tag values. Use when asked to query metrics, explore metric datasets, check metric values, or investigate OTel metrics data.

Quality

89%

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.

A highly actionable, well-sequenced operational skill: executable commands throughout, a gated workflow with real error-recovery loops, and tight, domain-specific prose that avoids padding. The main defect is a broken bundle reference — README.md is cited for setup and configuration but absent — which undermines navigation at the exact point a user would need it most.

Suggestions

Add the missing README.md to the bundle (or inline the ~/.axiom.toml setup essentials) — the reference at the top of the body currently dead-ends.

Trim secondary detail: drop the JSON request-body example under Parameters and the full resolution-ladder enumeration, keeping just the behavior (snapped up, never below stored resolution).

Consider moving the metrics-info subcommand table into a reference file or trimming it to the most-used commands, keeping the discovery essentials in the workflow section.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious domain knowledge (MPL gotchas, $__interval mechanics, cardinality warnings, shell-quoting traps) and never pads with concepts Claude already knows. A few spots could be trimmed — the full request-body JSON example, the enumerated resolution ladder, and the largely self-evident 401/404 rows of the error table — so it does not reach "every token earns its place" at anchor 5, but it is well above anchor 3.

4 / 5

Actionability

Every workflow step is an exact executable invocation, the two example queries plus the parameters example are copy-paste ready, and the flag/parameter tables give concrete values. Verified against the bundle: all referenced scripts (datasets, metrics-spec, metrics-info, metrics-query, axiom-api, resolve-url, setup) exist with matching usage strings.

5 / 5

Workflow Clarity

The numbered workflow gates composition behind a required step ("metrics-spec — required before composing any query"), adds a pre-query check (read {type, temporality, unit} before writing the query), and the Error Handling section supplies explicit feedback loops: read the annotated 400 pointer and fix, back off on 429, capture the trace ID on 500. No destructive/batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

Section structure is good and the deep MPL material is properly delegated one level deep to the runtime-fetched scripts/metrics-spec ("the spec is the source of truth"), but the setup/prerequisites pointer "see README.md" references a file that does not exist in the bundle — a broken navigation path for anyone needing configuration. Between anchors 3 and 4, the dangling reference is more than a minor organization gap, landing at 3 rather than 4.

3 / 5

Total

17

/

20

Passed

Description

87%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 capabilities in third person, an explicit "Use when…" clause with natural trigger phrases, and a clearly scoped niche around Axiom/OTel metrics. The only weaknesses are modest — a couple of missing natural synonyms (telemetry, time series) and slightly thin coverage of what the skill can do beyond query and discovery.

DimensionReasoningScore

Specificity

"Runs metrics queries against Axiom MetricsDB via scripts. Discovers available metrics, tags, and tag values." names the domain plus several concrete actions (run queries, discover metrics, tags, tag values). It is not 5 because coverage has minor gaps (nothing about query composition guidance or the MPL spec lookup); not 3 because it lists more than 1-2 concrete actions.

4 / 5

Completeness

Both halves are explicit: what it does ("Runs metrics queries… Discovers available metrics, tags, and tag values") and when to use it ("Use when asked to query metrics, explore metric datasets, check metric values, or investigate OTel metrics data") with concrete trigger phrases — a direct match for the anchor-5 example pattern. Not 4, since the when-clause is already specific rather than generic.

5 / 5

Trigger Term Quality

The when-clause supplies natural phrases users would say — "query metrics", "explore metric datasets", "check metric values", "investigate OTel metrics data" — plus the product name "Axiom MetricsDB". A few natural synonyms are missing (e.g. "telemetry", "time series", "monitoring"), so it sits between anchor 4 and 5 but closer to 4.

4 / 5

Distinctiveness Conflict Risk

"Axiom MetricsDB" and "OTel metrics data" carve a clear niche with metric-specific triggers, so confusion with sibling observability skills (logs, traces) is unlikely. The triggers are consistently metrics-scoped, matching the minimal-conflict anchor.

5 / 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

openclaw/clawhub

Path

.agents/skills/query-metrics/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.