Obs Query
SkillSearchExecute PromQL or LogQL queries against Prometheus and Loki. Use this skill whenever the user wants to run a custom query, check a specific metric value, search logs, asks "what is the value of metric X", wants to explore data in Prometheus or Loki, or pastes a PromQL/LogQL expression. Also use when the user asks to query traces, check recording rules output, or debug metric values that don't match dashboard expectations.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Obs Query skill
What this skill tells your AI
The instructions your AI receives, as published by shepard-system/shepard-obs-stack in .claude/skills/obs-query/SKILL.md and read by ahel’s review.
Execute arbitrary PromQL or LogQL queries and present results.
Query type detection
- LogQL: starts with
{(stream selector) → route to Loki - PromQL: everything else → route to Prometheus
How to execute
PromQL instant query
scripts/obs-api.sh prom /api/v1/query --raw --jq '.data.result' --data-urlencode "query=<EXPR>"
PromQL range query
scripts/obs-api.sh prom /api/v1/query_range --raw --jq '.data.result' --data-urlencode "query=<EXPR>" --data-urlencode "start=$(date -v-1H +%s)" --data-urlencode "end=$(date +%s)" --data-urlencode "step=60"
LogQL query
scripts/obs-api.sh loki /loki/api/v1/query_range --raw --jq '.data.result' --data-urlencode "query=<EXPR>" --data-urlencode "limit=20"
Examples
For a comprehensive list of PromQL and LogQL examples, read references/examples.md in this skill directory.
Output
For output format options (table/csv/json), read .claude/skills/obs-shared/assets/output-formats.md.
Instructions
- Take the user's query from the skill argument (everything after
/obs-query) - If no query provided, read
references/examples.mdand show common examples - Detect query type and execute with appropriate endpoint
- Format results as table (instant vectors), summary (range), or log lines
- If query fails, show the error and suggest fixes
- Safety: read-only GET queries only — never POST, PUT, DELETE, or admin endpoints
Signals
- GitHub stars
- 70
- Forks
- 6
- Last commit
- Mar 2026
Advanced
- Catalog kind
- skill
- Gateway key
obs-query- Source
- github.com/shepard-system/shepard-obs-stack