CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prometheus-configuration

Complete guide to Prometheus setup, metric collection, scrape configuration, and recording rules.

Quality

73%

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/prometheus-configuration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 highly actionable, with complete copy-paste-ready configs and built-in promtool validation arranged in a coherent install-to-troubleshoot progression. However, all five referenced bundle files are missing (dead pointers), the large config/rule content that belongs in those files is inlined, and generic filler sections pad the token cost.

Suggestions

Create the referenced bundle files (references/scrape-configs.md, references/recording-rules.md, assets/prometheus.yml.template, scripts/validate-prometheus.sh, resources/implementation-playbook.md) — or remove the dead references — since none currently exist in the bundle.

Move the full prometheus.yml, recording-rule, and alert-rule listings into the reference files, keeping only minimal working examples inline so SKILL.md serves as a true overview.

Cut the generic "Instructions" and "Do not use this skill when" filler and the duplicated scrape-config patterns to reduce token cost without losing actionability.

DimensionReasoningScore

Conciseness

The complete YAML and command examples largely earn their tokens, but generic filler ("Clarify goals, constraints, and required inputs", "Apply relevant best practices and validate outcomes", "The task is unrelated to prometheus configuration") and duplication (static-target and Kubernetes service-discovery patterns each appear twice, and full configs are inlined that the referenced files also claim to hold) add noticeable padding. Not a 2 because there is no conceptual over-explanation of things Claude already knows, but not a 4 due to the filler and repeated patterns.

3 / 5

Actionability

Fully executable and copy-paste ready throughout: a complete "helm install ... kube-prometheus-stack" command, a Docker Compose service, a full prometheus.yml with relabel_configs, complete recording and alert rule groups, and "promtool check config" / curl validation commands. Specific examples cover the common cases.

5 / 5

Workflow Clarity

Sections follow a natural install → configure → rules → validate → troubleshoot order, and explicit validation checkpoints are present ("promtool check config prometheus.yml", "promtool check rules /etc/prometheus/rules/*.yml"). It stays at 4 rather than 5 because no step sequence is stated and there is no fix-and-retry feedback loop after validation; not 3 because checkpoints are explicit, not merely implied.

4 / 5

Progressive Disclosure

The body clearly signals references ("See `references/scrape-configs.md`", "`assets/prometheus.yml.template`", "`scripts/validate-prometheus.sh`", "`resources/implementation-playbook.md""), but none of these files exist in the bundle — the references/, scripts/, and assets/ directories are absent, so every pointer is dead. Additionally, the full prometheus.yml, recording-rule, and alert-rule listings that belong in those files are inlined, duplicating the promised split. Scored against the actual bundle structure, this matches "content that clearly belongs in separate files is inlined" with broken navigation.

2 / 5

Total

14

/

20

Passed

Description

70%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 names a specific domain and several concrete capability areas using natural trigger terms, with very low conflict risk. Its main weakness is the complete absence of a "Use when" clause, which caps completeness, and missed alerting/monitoring keywords.

Suggestions

Add an explicit trigger clause, e.g. "Use when setting up or configuring Prometheus, writing scrape configs, or creating recording or alert rules."

Include alerting/monitoring keywords users naturally say — "alerting", "alert rules", "PromQL", "prometheus.yml" — to broaden trigger coverage.

Replace the "Complete guide to..." framing with direct third-person action statements, e.g. "Configures Prometheus scraping, recording rules, and alerting for infrastructure and application monitoring."

DimensionReasoningScore

Specificity

"Prometheus setup, metric collection, scrape configuration, and recording rules" lists several concrete capability areas in a specific domain, with only minor coverage gaps (no alerting or service discovery). It stays at 4 rather than 5 because the noun-phrase "Complete guide to..." framing is not the comprehensive verb-action style of the top anchor, and "setup" is comparatively generic.

4 / 5

Completeness

The "what" is clear — a guide covering setup, metric collection, scrape configuration, and recording rules — but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description, which caps completeness at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

Terms like "Prometheus setup", "scrape configuration", and "recording rules" are natural phrases users would say when needing this skill. It falls short of 5 because common variations are missing: no "alerting", "alert rules", "monitoring", "PromQL", or "prometheus.yml".

4 / 5

Distinctiveness Conflict Risk

"Prometheus" combined with tool-specific artifacts ("scrape configuration", "recording rules") carves out a clear niche with distinct triggers and minimal conflict risk against generic monitoring or other-tool skills.

5 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/prometheus-configuration/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.