CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

enhanced-telemetry

Comprehensive Claude Code telemetry via 10 hooks capturing sessions, conversations, tools, subagents, context, permissions, and repository analytics. Use when analyzing detailed usage patterns beyond default OTEL.

Quality

81%

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

The canonical home for this skill is enhanced-telemetry in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-organized, highly actionable reference document: configuration, queries, test commands, and event schemas are all copy-paste ready, and troubleshooting forms an explicit diagnostic checklist. The main weaknesses are the inlined event-schema reference material that belongs in a separate file and partial redundancy between the "What It Captures" list and the hooks table.

Suggestions

Move the ~95-line "Event Schemas" section (and optionally the full settings.json block) into a separate reference file (e.g., references/events.md) and keep a one-line-per-event summary in SKILL.md, turning the skill into a lean overview with one-level-deep references.

Collapse the "What It Captures" section into the "10 Hooks Instrumented" table (or vice versa) to remove the overlap between the two lists and trim the token budget.

Add a short numbered setup sequence (install hook script -> configure settings.json -> restart session -> verify data in Loki) so the primary workflow is proactive rather than only reachable through the Troubleshooting section.

DimensionReasoningScore

Conciseness

The body is dense and factual (hook table, config JSON, LogQL queries, event schemas) with no explanations of concepts Claude already knows. The "What It Captures" section partially overlaps the "10 Hooks Instrumented" table, though it adds items (e.g., "Prompt patterns (question/debugging/creation/ultrathink)", "Branch-level tracking") not stated elsewhere — minor trimmable redundancy matching anchor 4 rather than anchor 3's unnecessary explanation.

4 / 5

Actionability

Everything written is copy-paste ready: the complete settings.json hook configuration, ten full LogQL queries, a manual script test ("echo '{\"tool_name\"\":\"Test\"}' | python3 .claude/hooks/enhanced-telemetry.py PreToolUse"), and curl verification commands covering the common configuration, query, and troubleshooting cases. This matches anchor 5 (fully executable, specific examples cover the common cases).

5 / 5

Workflow Clarity

The Troubleshooting section provides a numbered diagnostic sequence with explicit checkpoints (check hooks configured, test script manually, check Loki labels, check enhanced data), and the skill involves no destructive or batch operations so no cap applies. It falls short of anchor 5 because validation is reactive (troubleshooting) rather than a proactive feedback loop, and no explicit numbered setup sequence is given up front.

4 / 5

Progressive Disclosure

The file is well-sectioned with clear headers, but it is a single ~280-line document with no bundle reference files at all. The ~95-line "Event Schemas" section (and the full hook configuration) is inline reference material that would serve better in a separate file, matching anchor 3 (content that should be separate is inline). It is not anchor 2 (structure is clear, not buried) and not anchor 4 (the inline schema reference is more than a minor placement gap).

3 / 5

Total

16

/

20

Passed

Description

75%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 with a clear what, an explicit "Use when..." clause, and specific coverage of the seven analytics domains and 10-hook mechanism. It sits just below top marks because the action verbs are generic, trigger synonyms (monitoring, metrics, observability) are absent, and only one trigger scenario is given.

DimensionReasoningScore

Specificity

"capturing sessions, conversations, tools, subagents, context, permissions, and repository analytics" names seven concrete capture areas plus the mechanism ("via 10 hooks"), giving broad specific coverage, though the verbs ("capturing", "analyzing") are generic rather than distinct concrete actions. It exceeds anchor 3 (only 1-2 concrete actions) but falls short of anchor 5's multiple distinct concrete verbs.

4 / 5

Completeness

The "what" is clear (10 hooks, seven analytics categories) and the "when" is explicit ("Use when analyzing detailed usage patterns beyond default OTEL"). It is not anchor 3 because the when-clause is explicit rather than implied, and not anchor 5 because only one trigger scenario is given rather than multiple concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural terms for the domain are present: "telemetry", "usage patterns", "analytics", "hooks", "OTEL", "Claude Code". Common synonyms like "monitoring", "metrics", or "observability" are missing, which matches anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"beyond default OTEL" carves a distinct enhanced-telemetry niche with hook-based triggers. Minor overlap risk exists with the closely related observability skills referenced in the body (observability-analyzer, observability-pattern-detector), matching anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

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

fernandezbaptiste/Skrillz

Path

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