CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

observability-analyzer

Query and analyze Claude Code observability data (metrics, logs, traces). Use when analyzing performance, costs, errors, tool usage, sessions, conversations, or subagents.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/observability-analyzer/SKILL.md

The canonical home for this skill is observability-analyzer in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 a dense, executable query catalog with clear per-operation outputs — genuinely useful and largely free of padding prose. Its weaknesses are the duplicated Key Queries section, inlined reference tables that should live in bundle files, and loose coupling between documented operations and the actual scripts (including a missing script reference).

Suggestions

Remove or collapse the 'Key Queries' section — it repeats queries already shown in the Operations section; keep only the few genuinely new ones (tool sequences, compaction, permissions) inline.

Move the Event Types Reference table and Grafana Dashboards list into a reference file (e.g., references/event-types.md) and link to it from SKILL.md, keeping the body as an overview of operations.

Fix the bundle coupling: create or remove the referenced `scripts/analyze-sessions.sh`, and state explicitly how each operation name (`query-metrics`, `analyze-errors`, etc.) maps to a script invocation (e.g., `scripts/query-prometheus.sh '<promql>'`).

DimensionReasoningScore

Conciseness

The body is mostly efficient — tables and executable queries with no explanations of concepts Claude already knows — but the 'Key Queries' section substantially repeats queries already shown in the Operations section (tool errors, session_end, context_utilization, Task tool calls, skill_usage, prompt patterns). Fits anchor 3 ('mostly efficient but... could be tightened') rather than anchor 2, since the padding is duplication rather than concept explanation.

3 / 5

Actionability

Concrete, copy-paste-ready LogQL/PromQL examples cover each analysis type, meeting anchor 4. Not anchor 5: operation names like `query-metrics` and `query-logs` are never mapped to the actual script files, the `--since 24h` flag syntax shown does not match the scripts' positional-argument interface, and `scripts/analyze-sessions.sh` is referenced but missing from the bundle.

4 / 5

Workflow Clarity

Each operation pairs a query with its expected output ('**Output**: Error types, frequencies, affected tools...') and queries are read-only, so no destructive-operation validation cap applies. Anchor 4 rather than 5 because invocation mechanics are inconsistent between the documented operation syntax and the script interfaces, and `generate-report` lists no command or query at all.

4 / 5

Progressive Disclosure

Sections are well-organized and the Scripts section points to bundle files, but ~185 lines of inlined reference material (Key Queries, Event Types Reference table, Grafana dashboard list) is content that belongs in a separate reference file, and one referenced path (`scripts/analyze-sessions.sh`) does not exist. Fits anchor 3 ('content that should be separate is inline') rather than 4, whose structure assumes the bulk is appropriately split out.

3 / 5

Total

14

/

20

Passed

Description

82%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: concise, third-person, with an explicit 'Use when' trigger clause covering natural analytics terms. Its only weakness is modest action specificity — 'query and analyze' undersells the range of analysis operations the body documents.

DimensionReasoningScore

Specificity

Names the domain ('Claude Code observability data (metrics, logs, traces)') with two concrete actions ('Query and analyze'), but does not enumerate the several specific capabilities the skill actually offers (error grouping, cost analysis, session analytics). Fits anchor 3 ('1-2 concrete actions, but not comprehensive') and not anchor 4, which requires a list of several specific actions.

3 / 5

Completeness

Clearly answers what ('Query and analyze Claude Code observability data (metrics, logs, traces)') and when with an explicit 'Use when analyzing...' clause listing concrete triggers, matching the anchor-5 good example structure exactly. Not below 5 since neither half is missing or vague.

5 / 5

Trigger Term Quality

'performance, costs, errors, tool usage, sessions, conversations, or subagents' are natural phrases a user would say when needing this skill. Not anchor 5 because it lacks synonyms and equivalents (e.g., 'telemetry', 'spending', 'debugging failures', 'usage stats') that users might naturally use.

4 / 5

Distinctiveness Conflict Risk

'Claude Code observability data' pins a clear niche with distinct telemetry-specific triggers, matching anchor 5 ('clear niche with distinct triggers; minimal conflict risk'). Broad terms like 'errors' or 'performance' are grounded by the observability-data qualifier, so it does not fall to anchor 4's 'minor overlap risk'.

5 / 5

Total

17

/

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: 1 missing

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/observability-analyzer/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.