Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/conallob/o11y-analysis-toolsnpx agentmods add skills/conallob/o11y-analysis-tools/promql-fmtWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/conallob/o11y-analysis-tools/promql-fmt)<a href="https://agentmods.dev/skills/conallob/o11y-analysis-tools/promql-fmt"><img src="https://agentmods.dev/badge/skills/conallob/o11y-analysis-tools/promql-fmt/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/conallob/o11y-analysis-tools/promql-fmt"><img src="https://agentmods.dev/badge/skills/conallob/o11y-analysis-tools/promql-fmt.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.01327 |
| Opus 5.5 | $0.00000 | $0.00531 |
| Sonnet 5.5 | $0.00000 | $0.00265 |
| Haiku 4.5 | $0.00000 | $0.00133 |
Grade A, and why
promql-fmt scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 116 lines — stays where its author put it; the contents beside it link to each section on GitHub.
promql-fmt
Static analyzer and auto-formatter for PromQL expr:/query: fields inside
Prometheus-style rule YAML files. Hermetic — it only reads the files you
point it at.
When to use this skill
- A user is authoring or editing a Prometheus/Thanos/Cortex/Mimir alert or recording rule and wants it formatted consistently.
- You're reviewing a diff to rule YAML and want to catch style or best-practice violations before commit.
- You're wiring a CI job that should fail a PR touching rule files with inconsistent formatting.
Setup
go build -o bin/promql-fmt ./cmd/promql-fmt
# or: go install github.com/conallob/o11y-analysis-tools/cmd/promql-fmt@latest
Usage
promql-fmt [options] <file|directory>...
Only .yml/.yaml files are scanned; directories are walked recursively.
There is no stdin mode (unlike label-check) — always pass a file or
directory path.
| Flag | Default | Effect |
|---|---|---|
--check |
true |
Report issues, exit 1 if any found. Do not modify files. |
--fix / --fmt |
false |
Rewrite files in place with the formatted output. --fmt is an alias for --fix. Passing either disables --check automatically. |
--verbose |
false |
Print per-file "Fixing …" lines while fixing. |
--disable-line-length |
false |
Suppress the "should use multiline formatting" nudge for long lines — useful for recording rules with unavoidably long metric names. |
--prometheus-url |
"" |
Optional. If set, additionally queries that Prometheus for timeseries continuity — i.e., flags expressions that reference metrics with no matching series. This is the one non-hermetic opt-in check; omit the flag to stay fully offline. |
Typical invocations
# CI gate / pre-commit check (default mode)
promql-fmt --check ./prometheus/
# Auto-fix in place, then re-check
promql-fmt --fix ./prometheus/
# Verbose fix, skip line-length nudges for long recording-rule names
promql-fmt --fix --verbose --disable-line-length ./prometheus/recording-rules.yml
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 116 lines · 0 tokens per session scan A 28a37ac88323
promql-fmt is a skill published in the GitHub repository conallob/o11y-analysis-tools (4 stars, last pushed 12d ago), licensed BSD-3-Clause. It costs nothing until one of its globs matches a file; then it loads 1,327 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
Observability with Prometheus & Grafana
Production-grade observability stack with Prometheus metrics, Grafana dashboards, PromQL query language, alerting rules, and AI-powered anomaly detection for modern cloud-native applications.
scanning-kubernetes-manifests-with-kubesec
Perform security risk analysis on Kubernetes resource manifests using Kubesec to identify misconfigurations, privilege escalation risks, and deviations from security best practices.
i18n-lookup
Look up Zeabur platform UI term translations from the dashboard i18n files. Use when writing or reviewing docs that reference UI elements (button labels, tab names, menu items) to ensure docs match the actual platform translations.
translate
Translate documentation pages to all missing locales. Use when a document exists in one locale but needs to be translated to others. Supports --dry-run, single-locale targeting, and incremental updates.
contextlint-impact
Analyze the impact of changing or deleting a Markdown document by leveraging contextlint's Context Graph. Use this skill whenever the user asks "what breaks if I change X?", "what depends on this doc?", "is it safe to delete this file?", or wants to plan a refactor / understand cross-doc dependencies — even if they…
contextlint-init
Bootstrap contextlint into a repository. Use this skill whenever the user wants to set up, install, initialize, or configure contextlint — even if they only say "lint setup", "doc integrity check", or "set up Markdown linting" without naming contextlint by name. Detects the package manager (bun/npm/pnpm/yarn), scans…