skills.rest
shepard-systemshepard-systemOfficial·6 Agent Skills Included

shepard-obs-stack

Self-hosted observability dashboards for coding assistant usage and cost

Tracks cost, token usage, tool calls, and sessions across Claude Code, Codex, and Gemini CLI. Replaces guesswork about coding assistant spend with nine auto-provisioned Grafana dashboards and real-time alerts. Runs entirely on localhost via Docker, keeping all telemetry data private on your own machine.
70|6
↗
npx skills add shepard-system/shepard-obs-stack --all -g -y
Available:

Gives your AI agent the stack architecture, metric naming conventions, and query commands it needs to operate and troubleshoot this observability pipeline correctly.

All Skills in This Repository (6)

Pure Emerald Level Indicators
📦 In Repo
shepard-systemshepard-system

obs-tools

Analyze AI tool invocation metrics from Prometheus data over 24 hours.

Official
Intermediate
📦 In Repo
shepard-systemshepard-system

obs-sessions

Retrieve recent AI coding sessions with provider, model, duration, and cost.

Official
Intermediate
📦 In Repo
shepard-systemshepard-system

obs-status

Check operational status of Grafana, Loki, Prometheus, Alertmanager, and Tempo services.

Official
Basic
📦 In Repo
shepard-systemshepard-system

obs-alerts

Retrieve active alerts, silences, and Prometheus rule states via Alertmanager and Prometheus APIs.

Official
Intermediate
📦 In Repo
shepard-systemshepard-system

obs-cost

Monitor AI coding assistant costs and token usage across providers.

Official
Intermediate
📦 In Repo
shepard-systemshepard-system

obs-query

Execute PromQL and LogQL queries against Prometheus and Loki.

Official
Intermediate

Frequently Asked Questions

FAQPage Schema
How to install shepard-obs-stack?▼

Run `npx skills add shepard-system/shepard-obs-stack --all -g -y` in your terminal to install all skills in this suite globally.

How to track AI coding assistant costs?▼

Start the stack with ./scripts/init.sh, install the hooks, and the Cost dashboard shows spend by provider and model in real time. You can also ask your agent directly with the /obs-cost skill.

Which coding assistants does it support?▼

It supports Claude Code, Codex, and Gemini CLI through bash hooks plus native OpenTelemetry export. All three feed into the same Prometheus, Loki, and Tempo pipeline.

Does my telemetry data leave my machine?▼

No. Everything runs locally in Docker containers on localhost, so all metrics, logs, and traces stay on your own machine.

Can I query metrics without opening Grafana?▼

Yes. The seven included skills let your agent run status checks, cost reports, session history, and free-form PromQL or LogQL queries directly from the terminal.

Related Repositories in Software Engineering

View All in Software Engineering→
openclawopenclaw
388.4k

openclaw

Run a personal AI assistant across your devices and chat apps

Official📦 120 Skills
obraobra
280.0k

superpowers

Gives coding agents a disciplined workflow from idea to merged code

Community📦 15 Skills
facebookfacebook
248.4k

react

AI agent skills for building, testing, and porting React core

Official📦 14 Skills