CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-code-telemetry-enable

Enable and configure Claude Code OTEL telemetry for local or Railway observability stacks. Use when setting up Claude Code to send metrics, logs, and traces to observability backends.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/claude-code-telemetry-enable/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well-structured and highly actionable, with concrete configs, a clear enable→verify workflow, and useful troubleshooting. Its main defects are duplicated env-var content inflating token cost and a References/Scripts section that promises five files missing from the bundle, breaking progressive-disclosure navigation.

Suggestions

Reconcile the bundle with the body's references: create or restore `references/env-telemetry-custom.txt`, `references/telemetry-variables.md`, `references/privacy-settings.md`, `scripts/enable-railway.sh`, and `scripts/disable-telemetry.sh`, or remove their entries from the References/Scripts sections; also list the existing `scripts/activate-telemetry.sh`.

De-duplicate the environment-variable content: keep one authoritative copy (either the `enable-local` block or `references/env-telemetry-local.txt`) and point to the reference file instead of repeating the full config under "Configuration Details" as well.

Trim illustrative padding to reduce token budget: the simulated `status`/`verify` output blocks and the "Next Steps" section add length without executable value — replace with the actual verify command and one-line expected-result checks.

DimensionReasoningScore

Conciseness

Mostly efficient configuration data with no explaining of concepts Claude already knows, but noticeably duplicated: the full env-var block appears under `enable-local`, again under "Configuration Details > Environment Variables", and again in `references/env-telemetry-local.txt`; the "Next Steps" section ("Use Claude Code", "Generate telemetry") is pure padding. Not 4 — several sections need tightening to earn the 4 anchor.

3 / 5

Actionability

Mostly executable guidance: copy-pasteable env blocks, exact file paths ("~/.config/claude-code/.env.telemetry"), concrete troubleshooting commands ("curl -s 'http://localhost:3100/loki/api/v1/query?query={job=\"claude_code\"}'"). Not 5 — the operation-invocation mechanism is ambiguous ("Invoke this skill with: enable-local" inside a bash block vs. the actual `scripts/enable-local.sh`), and two of the four listed scripts (`enable-railway.sh`, `disable-telemetry.sh`) do not exist in the bundle.

4 / 5

Workflow Clarity

Clear sequence (stack deployed → enable → verify → view in Grafana) with an explicit 5-check `verify` operation and a Troubleshooting section providing error-recovery feedback loops (telemetry not appearing, port in use, permission denied). Not 5 — checkpoints reference operations whose scripts are partly missing, so the validate→fix→retry loop cannot always be executed as written.

4 / 5

Progressive Disclosure

Scored against the actual bundle: content that clearly belongs in separate named files is inlined (the full env config duplicates `references/env-telemetry-local.txt`; the env-variable catalog belongs in `references/telemetry-variables.md`), and navigation is materially broken — `references/env-telemetry-custom.txt`, `references/telemetry-variables.md`, `references/privacy-settings.md`, `scripts/enable-railway.sh`, and `scripts/disable-telemetry.sh` are all listed but absent, while `scripts/activate-telemetry.sh` exists unlisted. Not 3 — while section structure is good and the References/Scripts lists are clearly signaled, the majority of promised navigation targets dangle.

2 / 5

Total

13

/

20

Passed

Description

73%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 solid description: explicit what and when, third-person imperative voice, good natural trigger keywords, and a distinct niche. The when-clause could enumerate more concrete trigger scenarios and the action list could mention verification/configuration outcomes beyond generic "enable and configure".

DimensionReasoningScore

Specificity

Names the domain precisely ("Claude Code OTEL telemetry for local or Railway observability stacks") with 1-2 concrete actions ("Enable and configure"), but the verbs are generic and the when-clause's "send metrics, logs, and traces" is the only concrete capability detail. Not 4 because it lacks the several distinct concrete actions of the 4 anchor (no verify, disable, or custom-endpoint coverage).

3 / 5

Completeness

Both parts are present: what ("Enable and configure Claude Code OTEL telemetry for local or Railway observability stacks") and an explicit when ("Use when setting up Claude Code to send metrics, logs, and traces to observability backends"). Not 5 because the when-clause covers a single trigger scenario and is less concrete than the 5 anchor's multiple trigger phrases (no user-mention triggers like "mentions telemetry" or "Grafana").

4 / 5

Trigger Term Quality

Good natural keyword coverage: "telemetry", "OTEL", "metrics, logs, and traces", "observability", "local or Railway". Missing common synonyms a user might say — "monitoring", "Grafana", "OpenTelemetry" spelled out, "OTLP" — so it falls short of the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: "Claude Code OTEL telemetry" plus named backends ("local or Railway observability stacks") — unlikely to fire for unrelated skills, matching the 5 anchor's clear-niche pattern.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/claude-code-telemetry-enable/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.