homelab-monitoring-analyst

Analyzes metrics, alerts, and logs from homelab services to identify issues and recommend remediation.

Quality

57%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/homelab-monitoring-analyst/SKILL.md

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.

The content is well-structured and concise with a sensible workflow and safety-aware handoffs, but it stays at a high level without concrete commands or queries. Adding executable examples would materially improve actionability and workflow clarity.

Suggestions

Add concrete executable commands to the workflow steps, e.g. `curl -s 'http://localhost:9090/api/v1/query?query=...'` or `journalctl -u <svc> --since '1 hour ago'`.

Insert an explicit validation checkpoint, such as confirming metric freshness or alert state before correlating.

Show a small correlation/diagnosis example (metric spike + restart event -> likely cause) to make the diagnose step concrete.

Dimension	Reasoning	Score
Conciseness	The body is lean and does not explain concepts Claude already knows (e.g., what Prometheus is), with only minor redundancy between the intro and the frontmatter description.	4 / 5
Actionability	Workflow steps name the data to gather (CPU/RAM/disk/network, alerts, logs) but provide no executable commands or queries, leaving the actual mechanics implicit rather than copy-paste ready.	3 / 5
Workflow Clarity	A clear 7-step sequence is present with a safety handoff via the homelab-safe-ops companion, but there are no explicit validation/checkpoint steps within the analysis flow itself.	3 / 5
Progressive Disclosure	Well-organized into clear sections (Workflow, Data Sources, Companion Skills, References) with one-level-deep external doc links; no bundle files exist to verify further, keeping it just short of 5.	4 / 5
	Total	14 / 20 Passed

Description

53%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 is clear and domain-specific but generic in its action verbs and lacks an explicit 'when to use' trigger clause. It is distinct enough for the homelab niche yet would benefit from concrete trigger phrases.

Suggestions

Add a 'Use when...' clause naming concrete trigger phrases such as 'when the user reports a homelab alert, spike, or anomalous metric'.

Replace generic verbs with specific actions (e.g., 'query Prometheus ranges', 'parse Alertmanager firing alerts', 'grep journalctl for restarts').

Include natural synonyms and tool-specific keywords users say (e.g., 'Prometheus', 'Grafana', 'Netdata', 'alert firing').

Dimension	Reasoning	Score
Specificity	Names the domain ('metrics, alerts, and logs from homelab services') and a few concrete actions ('Analyzes', 'identify issues', 'recommend remediation'), but the verbs are generic and coverage is not comprehensive.	3 / 5
Completeness	Gives a clear 'what' but provides no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric.	3 / 5
Trigger Term Quality	Includes some natural terms a user might say ('metrics', 'alerts', 'logs', 'homelab'), but lacks synonyms or common variations and has no explicit trigger phrasing.	3 / 5
Distinctiveness Conflict Risk	The 'homelab services' niche with monitoring-specific triggers is mostly distinct, with only minor overlap risk against general observability skills; not a fully unambiguous niche so it stays below 5.	4 / 5
	Total	13 / 20 Passed

Validation

100%

Warnings & errors only

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: pvnkmnk/AgenticSelfHostSkills
Path: skills/homelab-monitoring-analyst/SKILL.md
Commit: 0f62e6b

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.