CtrlK
BlogDocsLog inGet started
Tessl Logo

prometheus-configuration

Set up Prometheus for comprehensive metric collection, storage, and monitoring of infrastructure and applications. Use when implementing metrics collection, setting up monitoring infrastructure, or configuring alerting systems.

82

1.22x
Quality

75%

Does it follow best practices?

Impact

94%

1.22x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/observability-monitoring/skills/prometheus-configuration/SKILL.md

The canonical home for this skill is prometheus-configuration in wshobson/agents

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 content is highly actionable — concrete, executable configurations and commands cover installation, scraping, rules, validation, and troubleshooting. Its main flaws are duplication (full configs inlined alongside reference files covering the same material) and progressive disclosure failure: all four referenced bundle files do not exist, so the documented navigation leads nowhere. Workflow is sequenced implicitly by section order with real validation commands but no explicit error-recovery loops.

Suggestions

Create the referenced bundle files (assets/prometheus.yml.template, references/scrape-configs.md, references/recording-rules.md, scripts/validate-prometheus.sh) or remove the dangling references — currently every 'Reference:' pointer and the 'Reference Files' section leads to a non-existent path.

Move the full prometheus.yml, recording-rule catalog, and alert-rule catalog into the dedicated reference files and keep only a minimal working example plus the key decision points inline, cutting SKILL.md's ~400 lines substantially.

Add an explicit numbered workflow (install → write prometheus.yml → define rules → validate with 'promtool check config/rules' → verify targets via the API) with a fix-and-re-validate loop for failed checks.

DimensionReasoningScore

Conciseness

The body is mostly code with little concept padding, but it inlines a complete ~140-line prometheus.yml, a full recording-rule catalog, a full alert-rule catalog, and a Kubernetes architecture diagram — then repeats scrape-config patterns in a separate section and points to asset/reference files covering the same material. Not 2: there is no tutorial-style explanation of things Claude already knows; not 4: the duplication between inline content and the (referenced) dedicated files is a clear tightening opportunity.

3 / 5

Actionability

Copy-paste-ready guidance throughout: helm install with concrete flags, a docker-compose file, a complete prometheus.yml, working relabel_configs, recording/alert rule YAML, and promtool/curl commands for validation and troubleshooting. Matches the anchor-5 'fully executable, covers common cases' example; not 4: no meaningful execution gaps were found.

5 / 5

Workflow Clarity

The section order (Installation → Configuration → Scrape configs → Recording rules → Alert rules → Validation → Troubleshooting) forms a discernible install-configure-validate sequence, and the Validation section provides concrete promtool checkpoints plus a reference to a validate script. Not 5: the sequence is implicit in section order rather than an explicit numbered workflow with error-recovery loops (e.g., 'if promtool check config fails, fix and re-run'); not 3: validation commands are present and specific, not missing or implicit.

4 / 5

Progressive Disclosure

The body references four bundle files ("assets/prometheus.yml.template", "references/scrape-configs.md", "references/recording-rules.md", "scripts/validate-prometheus.sh"), but the bundle contains no references/, scripts/, or assets/ directories — every referenced path is dangling. Meanwhile ~250 lines of full configs and rule catalogs that the skill's own 'Reference Files' section says live in those files are inlined in SKILL.md. Not 3: the broken paths plus heavy inlining of content that clearly belongs in the referenced files goes beyond 'could be better organized'; not 1: section structure is clear and references are prominently signaled rather than buried.

2 / 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: it states what the skill does and gives explicit, naturally phrased trigger conditions anchored to the Prometheus niche. Its only weakness is that the capability list stays at the level of broad areas rather than the specific tasks the skill actually covers.

DimensionReasoningScore

Specificity

"Set up Prometheus for comprehensive metric collection, storage, and monitoring" names the domain with 1-2 concrete action areas (metric collection, storage, monitoring), but does not enumerate the skill's actual specific capabilities visible in the body (scrape configuration, recording rules, service discovery). Not 4: it stops at broad capability areas rather than listing several specific actions; not 2: the actions named are more than minimal/generic domain naming.

3 / 5

Completeness

Explicitly answers both: what — "Set up Prometheus for comprehensive metric collection, storage, and monitoring of infrastructure and applications"; when — "Use when implementing metrics collection, setting up monitoring infrastructure, or configuring alerting systems" with three concrete trigger conditions. Matches the anchor-5 example structure; not 4: the 'when' clause is already explicit and concrete, not merely adequate.

5 / 5

Trigger Term Quality

Natural trigger phrases include "implementing metrics collection", "setting up monitoring infrastructure", and "configuring alerting systems" — phrases a user would plausibly say. Not 5: common variations and synonyms such as "scrape/scraping", "scrape config", "observability", or "metrics scraping" are missing; not 3: coverage goes well beyond a single keyword like "Works with PDF files".

4 / 5

Distinctiveness Conflict Risk

"Prometheus" anchors a clear niche, and the trigger conditions are monitoring-specific, so it is unlikely to fire for unrelated skills. Not 4: there is no meaningful overlap risk — the named tool and triggers are unambiguous, though adjacent tools (Grafana) are only distinguished in the body, not the description.

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

Warning

Total

15

/

16

Passed

Repository
Dicklesworthstone/pi_agent_rust
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.