CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

telemetry-verify

The telemetry witness: reads what the services recorded during one closed window of traffic another skill produced (ui-verify, verify, a repro), traces each acceptance criterion from web event to backend trace to database, and finds errors behind a green UI, slow paths, and missing signals. Never edits code; run on its own, it posts its receipt to the PR's verify comment. Triggers on "check the telemetry", "prove it with traces", "/telemetry-verify".

Quality

93%

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

96%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 exceptionally tight, operational skill body: lean sequencing with validation checkpoints and feedback loops, executable commands, and an exact output contract. The single gap is that the referenced rules/ and aw-verify files are absent from the bundle, leaving progressive disclosure unverifiable.

Suggestions

Ship the referenced rules/ files (expectations.md, receipt.md, dash0-mcp.md, logs.md) inside the skill bundle so the one-level-deep references resolve and the placement of backend-specific detail can be verified.

Include the ../aw-verify/scripts/verify-comment.mjs dependency (or document how to obtain it) so the posting command in Step 6 is executable from the bundle alone.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout — it never explains what telemetry, traces, or ingest are — and every line is operational ('Query from = --from − 30 s ... at most 4 attempts', 'about 12 calls covers a run'). Not 4: there is no over-explanation that could be trimmed; the long Step 6 template is the literal output contract, not padding.

5 / 5

Actionability

Provides copy-paste ready material: the full Skill(...) invocation string, the exact verify-comment.mjs command, exact skip lines, the wrong/right ingest-retry contrast, and a worked example journey ('click "Save" → POST /api/views 201 (84 ms) → views-service PUT (21 ms) → postgres INSERT (4 ms)'). Not 4: as an instruction-type skill it covers the common cases concretely, delegating only per-backend query syntax to clearly named rule files.

5 / 5

Workflow Clarity

Steps 0–6 are strictly sequenced with explicit validation checkpoints: honest skip conditions, a bounded ingest-retry feedback loop, a pipe check before any absence is read as good news ('zero records everywhere after the retries is pipe: inconclusive'), a stop-as-soon-as-verified query budget, and a Definition-of-done checklist. Not 4: feedback loops and checkpoints are explicit at every risky juncture.

5 / 5

Progressive Disclosure

References are one level deep and well signaled ('Read only the backend file and rules/receipt.md § Output; the other rule files are for disputes', plus a backend→rule-file table). Not 5: the referenced rules/*.md and ../aw-verify script files are not present in this skill's bundle, so the reference targets and the placement of detail cannot be verified; not 3: the in-bundle structure, signaling, and navigation are otherwise excellent.

4 / 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, third-person, explicitly triggered, and clearly distinguished from sibling skills in the same workflow. Its only weakness is keyword coverage that omits a few natural synonyms (logs, spans, observability) users might say.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'reads what the services recorded during one closed window', 'traces each acceptance criterion from web event to backend trace to database', 'finds errors behind a green UI, slow paths, and missing signals', 'posts its receipt to the PR's verify comment' — comprehensively covering the skill's behavior. Not 4: there are no minor coverage gaps; read, trace, judge, and report actions are all explicitly enumerated.

5 / 5

Completeness

Explicitly answers what (read telemetry over a closed window, trace acceptance criteria, find hidden errors) and when ('Triggers on "check the telemetry", "prove it with traces", "/telemetry-verify"', plus context that the traffic comes from ui-verify, verify, or a repro). Not 4: the 'when' is explicit with concrete trigger phrases, not merely present.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases are present ('check the telemetry', 'prove it with traces', '/telemetry-verify') along with domain terms like 'traces', 'web event', and 'missing signals'. Not 5: common user variations such as 'logs', 'spans', or 'observability' are absent; not 3: several natural phrases users would actually say are covered.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — the read-only 'telemetry witness' over traffic other verify skills produced — explicitly contrasted with siblings ('ui-verify, verify, a repro') and bounded by 'Never edits code'. Not 4: its triggers ('check the telemetry', 'prove it with traces') are distinct and unlikely to fire for a neighboring skill.

5 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 7 missing

Warning

Total

13

/

16

Passed

Repository

mthines/agent-skills

Path

skills/testing/telemetry-verify/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.