Promql Validator
Validates Prometheus queries (PromQL) for correctness and potential errors, ensuring data integrity and accurate monitoring insights.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add promql-validator npx -- -y @trustedskills/promql-validator
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"promql-validator": {
"command": "npx",
"args": [
"-y",
"@trustedskills/promql-validator"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The promql-validator skill validates PromQL queries, ensuring they are syntactically correct and can be executed without errors. It provides feedback on query structure, variable usage, and potential issues that could prevent successful execution against a Prometheus data source. This helps in debugging and improving the reliability of monitoring dashboards and alerting rules.
When to use it
- Debugging PromQL queries: When you're building or modifying alerts or dashboard panels and unsure if your query is valid.
- Automated testing: Integrate into CI/CD pipelines to automatically validate changes to PromQL configurations before deployment.
- Learning PromQL: Use as a learning tool to understand the syntax and common errors in PromQL queries.
- Code review: Validate PromQL code during peer reviews to catch potential issues early on.
Key capabilities
- PromQL query validation
- Syntax error detection
- Error message reporting
Example prompts
- "Can you validate this PromQL query:
up{job="my-app"}?" - "Is this a valid Prometheus query:
sum(http_requests_total{job="api"}) by (endpoint)"?" - "Check the syntax of this PromQL expression and tell me if there are any errors:
rate(http_requests_total[5m]) > 10."
Tips & gotchas
The skill requires a basic understanding of PromQL syntax to interpret the validation results effectively. While it checks for syntax, it doesn't guarantee that the query will return meaningful data or behave as expected against your specific Prometheus setup.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.