CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

observability-control

Manage observability stack lifecycle (start, stop, backup, restore, upgrade). Use when controlling the LGTM stack for Claude Code monitoring.

Quality

70%

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/observability-control/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 lean, command-first reference with good actionability for routine operations, undermined by broken script references (every listed filename is wrong), a backup/restore pipeline that does not round-trip, and destructive operations (volume removal, dashboard restore) with no validation steps.

Suggestions

Fix the Scripts section to reference the actual bundle files (start.sh, stop.sh, status.sh, backup.sh, restart.sh) or rename the scripts to match; consider referencing restart.sh, which is currently orphaned.

Add validation around destructive operations: verify/warn before `docker volume rm` in fix-permissions, and confirm service health after restore before declaring success.

Make backup and restore round-trip: export each dashboard to its own file (or a JSON array with per-item POSTs) so the restore command works on the backup artifact, and replace the `/path/docker-compose.yml` placeholder in `restart` with the real path.

DimensionReasoningScore

Conciseness

The body is almost entirely command tables and executable snippets with zero concept padding — no explanations of what Docker or Grafana is — earning 'efficient; minor instances that could be trimmed'. It misses 5 because of verbatim duplication: the four-line Tempo permission fix appears identically in both `fix-permissions` and 'Tempo Permission Denied', and 'Quick Commands' repeats operations already covered.

4 / 5

Actionability

Nearly every operation ships a copy-paste command (docker compose up/down, curl health endpoints, jq dashboard export), satisfying 'mostly executable guidance; concrete code or commands'. The gaps that hold it below 5: `restart` uses a placeholder path (`docker compose -f /path/docker-compose.yml restart`) instead of the real path stated earlier, and the backup pipeline concatenates all dashboard JSON objects into one file (`xargs ... > backup/dashboards.json`) that the restore command then POSTs as a single dashboard payload — not executable as written.

4 / 5

Workflow Clarity

Operations are cleanly organized one-per-section, but destructive operations lack validation: `fix-permissions` runs `docker volume rm observability_tempo-data` (destroying Tempo data) with no pre-check or backup warning, and `restore` overwrites dashboards with no post-restore verification. Per the rubric, missing validation in destructive/batch workflows caps this at 3 even though sequencing is clear.

3 / 5

Progressive Disclosure

The Scripts section references five files — `scripts/start-stack.sh`, `scripts/stop-stack.sh`, `scripts/health-check.sh`, `scripts/backup-dashboards.sh`, `scripts/restore-dashboards.sh` — none of which exist in the bundle; the actual scripts are `start.sh`, `stop.sh`, `status.sh`, `backup.sh`, `restart.sh`, and one of those (`restart.sh`) is never referenced. Broken navigation references plus an all-inline ~165-line body matches 'minimal structure; references buried or misleading', which is below the 'references present but not clearly signaled' level 3.

2 / 5

Total

13

/

20

Passed

Description

67%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 proper third-person 'what + Use when...' structure and an enumerated action list. Its main weakness is trigger-term coverage: it relies on the acronym 'LGTM' and omits the component names (Grafana, Prometheus, Loki, Tempo, telemetry) users would naturally mention.

Suggestions

Replace or augment the jargon trigger 'LGTM stack' with natural phrases and component names, e.g., 'Use when starting, stopping, or backing up the Grafana, Prometheus, Loki, or Tempo monitoring stack for Claude Code telemetry'.

Add synonyms users would actually say — dashboards, logs, metrics, tracing, OTEL — to improve trigger-term coverage.

Give the actions concrete objects (e.g., 'back up and restore Grafana dashboards') so the what-clause is unambiguous.

DimensionReasoningScore

Specificity

The description names the domain ("Manage observability stack lifecycle") and lists five concrete actions ("start, stop, backup, restore, upgrade"), matching the several-specific-actions anchor. It falls short of the 5 anchor because the actions lack their objects (e.g., back up what — dashboards, volumes?) and 'upgrade' is asserted without any anchoring detail, leaving minor gaps in coverage.

4 / 5

Completeness

Both parts are explicit: the 'what' is "Manage observability stack lifecycle (start, stop, backup, restore, upgrade)" and the 'when' is "Use when controlling the LGTM stack for Claude Code monitoring". It is below the 5 anchor because the 'when' clause leans on the jargon term 'LGTM stack' rather than concrete trigger phrases users would say (e.g., 'restart Grafana', 'back up dashboards').

4 / 5

Trigger Term Quality

Relevant keywords exist ("observability stack", "LGTM stack", "backup", "restore", "monitoring"), but natural component-level terms users would actually say — Grafana, Prometheus, Loki, Tempo, telemetry, dashboards, logs — are missing, and 'LGTM' is jargon many users would not spontaneously say. This matches 'some relevant keywords but missing common variations or synonyms'; it is above level 2 because the terms present are domain-appropriate, not generic filler.

3 / 5

Distinctiveness Conflict Risk

"LGTM stack for Claude Code monitoring" carves out a clear niche with low conflict risk against unrelated skills. It sits below the 5 anchor because 'manage observability stack lifecycle' still overlaps mildly with generic Docker/devops monitoring skills, matching 'mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

15

/

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/observability-control/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.