jobe-skills/prometheus-oidc-query
Run PromQL queries, inspect alert state, and troubleshoot OAuth2 or OIDC client-credentials access to Prometheus-compatible APIs.
95
Quality
95%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly articulates specific capabilities (PromQL queries, alert inspection, OAuth2/OIDC validation, bearer-token troubleshooting) with a well-defined 'Use when...' clause. The technical terminology is appropriate for the target audience and creates strong distinctiveness from other skills. The description uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Run PromQL queries', 'inspect alert state', 'validate OAuth2 or OIDC client-credentials configuration', 'troubleshoot bearer-token access'. These are precise, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what (run queries, inspect alerts, validate auth config, troubleshoot access) AND when with explicit 'Use when...' clause covering query scenarios, auth/TLS troubleshooting, and alert inspection needs. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'PromQL', 'Prometheus', 'OAuth2', 'OIDC', 'bearer-token', 'TLS', 'alert state', 'token endpoint'. Good coverage of technical terms users working in this domain would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche combining Prometheus, PromQL, OAuth2/OIDC authentication, and bearer-token access. The specific combination of monitoring + auth troubleshooting creates a clear, non-conflicting scope. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that efficiently documents CLI tool usage with concrete commands and clear organization. The content respects token budget while providing actionable guidance. The main weakness is the lack of explicit error handling workflows for token acquisition or API failures, which would be valuable given the authentication-heavy nature of the task.
Suggestions
Add a brief error recovery workflow showing what to do when token acquisition fails vs when Prometheus API fails (e.g., 'If token fails: check_config.py -> verify credentials -> retry')
Include example output snippets for at least one command to clarify expected JSON structure
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, assuming Claude's competence with OAuth2/OIDC concepts and Prometheus. No unnecessary explanations of what Prometheus or tokens are; every line provides actionable information. | 3 / 3 |
Actionability | Provides specific, executable commands with exact script paths and flags. Each command is copy-paste ready with clear parameter syntax like `--expr '<promql>'` and `--state firing|pending|inactive`. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced and numbered, but lacks explicit validation checkpoints or error recovery guidance. For operations involving secrets and token acquisition, there's no feedback loop for handling failures between steps. | 2 / 3 |
Progressive Disclosure | Clean overview structure with a single, well-signaled reference to `docs/index.md` for detailed setup, configuration reference, and troubleshooting. Content is appropriately split between quick-reference and detailed documentation. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Install with Tessl CLI
npx tessl i jobe-skills/prometheus-oidc-queryReviewed
Table of Contents