CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

observability-alert-manager

Configure Grafana alerts for Claude Code anomalies and thresholds. Use when setting up monitoring alerts for sessions, errors, context usage, or subagents.

Quality

76%

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 ./.claude/skills/observability-alert-manager/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

65%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 lean and dense with executable LogQL templates and a complete Grafana API example, with no token waste on concepts Claude already knows. Its weaknesses are missing validation/verification checkpoints around create/delete operations, full inlining of the template library instead of splitting it into a reference file, and a Scripts section pointing at four files absent from the bundle.

Suggestions

Add validation checkpoints to the operations flow: after create-alert, verify with list-alerts; recommend test-alert before enabling notifications; require confirming the rule name before delete-alert.

Resolve the dangling script references — either ship the four files listed in the Scripts section or remove that section, and make the bash examples show the real invocation (e.g. 'scripts/create-alert.sh --name ...') instead of a bare create-alert command.

Move the 11 pre-built templates to a references/alert-templates.md, keep 2-3 representative examples inline, and drop the duplicated queries in Example Alert Configurations by referencing the template names instead.

DimensionReasoningScore

Conciseness

The body is query-dense with zero concept padding — 11 LogQL templates, a curl API example, and terse sections; it never explains what Grafana or Loki is. Not 5 because the "Example Alert Configurations" section repeats queries verbatim from the templates (e.g. 'count_over_time({job="claude_code_enhanced", event_type="tool_result", status="error"} [1h]) > 5' appears twice, as do the context-usage and duration queries), which could be trimmed. Not 3 because there is no unnecessary explanation, only mild duplication.

4 / 5

Actionability

Mostly copy-paste ready: all 11 templates give executable LogQL (e.g. 'absent_over_time({job="claude_code_enhanced"} [10m])') and the Grafana ruler API example is a complete curl POST. Not 5 because the bash examples invoke a bare 'create-alert' command while the Scripts section lists 'scripts/create-alert.sh' — and no scripts/ directory exists in the bundle, so the actual invocation (path, flags like --duration) cannot be executed as written.

4 / 5

Workflow Clarity

A rough sequence exists ("1. Navigate to Alerting → Alert rules ... 4. Configure conditions and notifications"; a test-alert operation is defined), but there are no validation checkpoints: no 'run list-alerts to confirm creation', no 'use test-alert before enabling', and the destructive delete-alert has no verification step. Per the rubric, a destructive operation without validation caps this dimension at 3.

3 / 5

Progressive Disclosure

Sections are well-labeled and navigation within the body is easy, but all 11 pre-built templates (~60 lines) are inlined when they are a natural references/ file, and the four referenced scripts ('scripts/create-alert.sh', 'scripts/list-alerts.sh', 'scripts/test-alerts.sh', 'scripts/import-alert-templates.sh') do not exist in the bundle — dangling references scored against the actual (empty) bundle structure. Not 2 because the body itself is well structured and navigable; not 4 because the references present are broken rather than clearly signaled.

3 / 5

Total

14

/

20

Passed

Description

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

The description cleanly answers both 'what' and 'when', with an explicit, enumerated 'Use when' clause covering sessions, errors, context usage, and subagents, and a distinct Grafana-for-Claude-Code niche. Its only notable weakness is a thin action list — 'configure alerts' is the sole concrete verb and 'anomalies and thresholds' stays generic.

DimensionReasoningScore

Specificity

"Configure Grafana alerts for Claude Code anomalies and thresholds" names a concrete domain and one concrete action (configure alerts), but "anomalies and thresholds" is generic and the description never enumerates other real actions (list, test, delete rules; notification channel setup). It matches the anchor for 'names domain and 1-2 concrete actions, but not comprehensive' — above 2 because the action and domain are concrete, below 4 because only one verb is offered.

3 / 5

Completeness

Both halves are explicit: what — "Configure Grafana alerts for Claude Code anomalies and thresholds"; when — "Use when setting up monitoring alerts for sessions, errors, context usage, or subagents", with concrete trigger scenarios. The 'when' clause is specific and enumerated, matching the 5 anchor ("clearly and explicitly answers both what AND when with concrete trigger phrases") rather than the 4 anchor where the 'when' "could be more explicit or specific".

5 / 5

Trigger Term Quality

Natural phrases are present: "Grafana alerts", "setting up monitoring alerts", "sessions, errors, context usage, or subagents" — terms a user would plausibly say when needing this skill. Not 5 because common variations like "alert rules", "notifications", or tool names (Slack/PagerDuty) are absent; not 3 because multiple concrete, natural trigger phrases are explicitly included rather than merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The pairing of "Grafana alerts" with "Claude Code" telemetry carves a clear niche with mostly distinct triggers. Not 5 because "monitoring alerts for sessions, errors" could still overlap with a generic observability or dashboard skill; not 3 because the Grafana + Claude Code combination is far more specific than 'somewhat specific but could overlap'.

4 / 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: 4 missing

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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