Happy Infra Metrics and Grafana
slopus/happy
Queries live Prometheus metrics and manages Grafana dashboards as code for Happy's infrastructure, using the grafanactl CLI and the Grafana datasource proxy API.
Use Grafana's GCX CLI for dashboards, datasources, Prometheus metrics, Loki logs, Tempo traces, alert rules, and Grafana resource operations.
Install Grafana Helper
$ npx skills add shepherdjerred/monorepo --skill grafana-helper -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install shepherdjerred/monorepo grafana-helper --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/grafana-helper .claude/skills/grafana-helper && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "grafana-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helper into .claude/skills/grafana-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grafana-helper", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helperType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add shepherdjerred/monorepo --skill grafana-helper -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install shepherdjerred/monorepo grafana-helper --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/grafana-helper .agents/skills/grafana-helper && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "grafana-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helper into .agents/skills/grafana-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grafana-helper", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shepherdjerred/monorepo --skill grafana-helper -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install shepherdjerred/monorepo grafana-helper --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/grafana-helper .cursor/skills/grafana-helper && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "grafana-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helper into .cursor/skills/grafana-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grafana-helper", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/shepherdjerred/monorepo.git --path packages/dotfiles/dot_agents/skills/grafana-helper--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add shepherdjerred/monorepo --skill grafana-helper -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install shepherdjerred/monorepo grafana-helper --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/grafana-helper .gemini/skills/grafana-helper && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "grafana-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helper into .gemini/skills/grafana-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grafana-helper", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install shepherdjerred/monorepo grafana-helperInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add shepherdjerred/monorepo --skill grafana-helper -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/grafana-helper .github/skills/grafana-helper && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "grafana-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helper into .github/skills/grafana-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grafana-helper", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shepherdjerred/monorepo --skill grafana-helper -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install shepherdjerred/monorepo grafana-helper --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/grafana-helper .opencode/skills/grafana-helper && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "grafana-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/grafana-helper into .opencode/skills/grafana-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grafana-helper", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
grafana-helper- GitHub stars
- 112
- Token cost
- ~1.1k tokens
- SKILL.md length
- 460 words
- Files
- 1
- Skills in repo
- 63
- Repo updated
- First seen
- Licence
- GPL-3.0
At a glance
Use Grafana's GCX CLI for dashboards, datasources, Prometheus metrics, Loki logs, Tempo traces, alert rules, and Grafana resource operations.
- Observability investigations
- SKILL.md covers Discover before operating, Query observability data, Inspect Grafana resources and Mutation boundary, plus 1 more section
- Needs GRAFANA_API_KEY
- Tasks that involve Monitoring and alerting
What it does
Grafana Helper is an agent skill from shepherdjerred/monorepo. Use Grafana's GCX CLI for dashboards, datasources, Prometheus metrics, Loki logs, Tempo traces, alert rules, and Grafana resource operations. Trigger for Grafana, GCX, dashboards, PromQL, LogQL, metrics, logs, traces, Tempo, alert rules, or observability investigations.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Monitoring and alerting. It works with Grafana and Prometheus. The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.
When your agent uses it
- Observability investigations
- Tasks that involve Monitoring and alerting
Example prompts
- “/grafana-helper”
Requirements
- A credential in GRAFANA_API_KEY
What it can do on your machine
Read from SKILL.md and the folder at commit d66c497. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
GRAFANA_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Grafana Helper loads about 1.1k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 460 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from shepherdjerred/monorepo at commit d66c497, republished under its GPL-3.0 licence (© shepherdjerred). 460 words, ~1,124 tokens.
Download SKILL.mdSave it as
.claude/skills/grafana-helper/SKILL.md (or your agent's skills folder).- name
- grafana-helper
- description
- Use Grafana's GCX CLI for dashboards, datasources, Prometheus metrics, Loki logs, Tempo traces, alert rules, and Grafana resource operations. Trigger for Grafana, GCX, dashboards, PromQL, LogQL, metrics, logs, traces, Tempo, alert rules, or observability investigations.
Grafana with GCX
Use Grafana's native gcx CLI. Inside shepherdjerred/monorepo, invoke it
through toolkit so the tracked homelab context is selected consistently:
toolkit grafana --version
toolkit grafana help-tree
toolkit grafana commandsUse native gcx directly outside the monorepo or when explicitly requested.
Do not recreate routine GCX capabilities with handwritten REST calls.
Discover before operating
GCX evolves quickly. Read help on the exact command instead of guessing flags:
toolkit grafana <group> --help
toolkit grafana <group> <command> --help
toolkit grafana agent skills list
toolkit grafana agent skills get <name> -o textPrefer --agent or -o json for machine-readable evidence. Use --json list
where offered to discover selectable fields. Never enable
--insecure-log-http-payload; it can expose authorization material.
Toolkit resolves GRAFANA_API_KEY automatically from the environment, a
toolkit config locator, or its registered 1Password service-account backend.
The tracked GCX configuration owns the homelab context; credential setup is
documented in packages/toolkit/README.md.
Do not run gcx login, print tokens, add credentials to
arguments, or create another config store during normal repository work.
Query observability data
Toolkit exposes focused aliases for the three signal backends:
toolkit prom query 'up == 0'
toolkit prom query 'rate(http_requests_total[5m])' --since 1h -o json
toolkit loki query '{namespace="temporal"} |= "error"' --since 1h --limit 50
toolkit loki query '{app="birmel"}' -o raw
toolkit tempo query --helpStart broad enough to establish scope, then narrow by service, namespace, deployment, endpoint, trace ID, and time window. Correlate signals rather than claiming a root cause from one log line or one metric spike. Record the exact query and time window in incident evidence.
For active alerts, distinguish the layers:
toolkit prom query 'ALERTS{alertstate="firing"}'shows firing Prometheus series.toolkit grafana alert rules listinspects Grafana-managed rule definitions and evaluation state.toolkit alerts list --state openshows the monorepo's durable alert occurrence ledger.
An empty Grafana-managed rule list is not an outage when Kubernetes
PrometheusRule resources and Alertmanager own alerting.
Inspect Grafana resources
Discover the command-specific flags first, then use native groups:
toolkit grafana dashboards --help
toolkit grafana dashboards list
toolkit grafana datasources --help
toolkit grafana alert rules list
toolkit grafana alert rules get <uid>Use toolkit grafana api only when GCX has no typed command for a required
read. Confirm the endpoint through current Grafana documentation or command
help, keep credentials inside GCX, and validate returned data before drawing a
conclusion.
Show full SKILL.md (165 more words)Show less
Mutation boundary
Dashboard, datasource, alert-rule, and other resource changes are external mutations. Require explicit user authorization and identify the exact context, resource, and intended diff before writing.
GCX's resource workflow is the preferred mutation surface:
toolkit grafana resources pull <resource-type> -p <directory>
toolkit grafana resources push --help
toolkit grafana resources delete --helpPull and inspect current state first. Validate generated files and the target context, then apply only the authorized resource set. After a write, read the resource back and verify the relevant runtime signal separately; a successful API response does not prove a dashboard query, alert evaluation, or telemetry pipeline works end to end.
Failure handling
- A missing context or credential is a setup failure; repair the tracked dotfiles path rather than bypassing it with an ad hoc token.
- A query error is evidence, not an empty result. Preserve stderr and the exit code.
- If GCX lacks a capability, state the gap before using
grafana api; do not silently fall back to an unvalidated curl recipe. - Keep reads and writes distinct. Investigation does not authorize dashboard, alert, annotation, or datasource changes.
© shepherdjerred, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in packages/dotfiles/dot_agents/skills/grafana-helper of shepherdjerred/monorepo.
Open the folder on GitHubat commit d66c497
Compare with similar skills
Grafana Helper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Grafana Helper this skillshepherdjerred/monorepo | 112 | — | ~1.1k | Automated safety check: Pass | GPL-3.0 | |
| Happy Infra Metrics and Grafanaslopus/happy | 24k | — | ~2k | Automated safety check: Notes | MIT | |
| Syncmetapawurb/hotpath-rs | 1.9k | — | ~1.2k | Automated safety check: Notes | MIT | |
| Optimize Slurm TopologyNVlabs/alpasim | 1.3k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Dashboard Previewm4r1k/Eneru | 149 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Alerting Irmgrafana/skills | 282 | 1 repos | ~1.9k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Syncmeta
pawurb/hotpath-rs
Sync changes from the hotpath, hotpath-macros and hotpath-drain crates to their meta counterparts (hotpath-meta, hotpath-macros-meta and hotpath-drain-meta).
Optimize Slurm Topology
NVlabs/alpasim
Optimize AlpaSim Slurm topology throughput using persistent local Prometheus/Grafana telemetry and run artifacts.
Dashboard Preview
m4r1k/Eneru
Visually verify Eneru browser-dashboard changes against a live daemon or audit an exact deployment.
- Official
Alerting Irm
grafana/skills
Configure Grafana Alerting, Incident Response Management (IRM), and SLOs end-to-end — provisions Grafana-managed and data-source-managed alert rules, contact points (Slack/PagerDuty/email/webhook)…
- Official
Dashboarding
grafana/skills
Build, modify, and ship Grafana dashboards as JSON via the HTTP API — panel types (timeseries / stat / gauge / table / heatmap / logs / traces / node-graph), gridPos 24-column layout, units…
More from shepherdjerred/monorepo
All 63 skills in this repoBun Runtime Best Practices
shepherdjerred/monorepo
Bun runtime APIs and current operational patterns for files, processes, modules, networking, databases, tests, and deployment.
Bun Test Patterns
shepherdjerred/monorepo
Current Bun test runner guidance for discovery, isolation, parallelism, sharding, changed tests, mocks, timers, snapshots, coverage, DOM Testing Library, and integration teardown.
Bun Workspaces
shepherdjerred/monorepo
Current Bun workspace guidance for isolated and hoisted linkers, catalogs, filters, scripts, dependency classes, lockfiles, lifecycle trust, caches, publishing, TypeScript package exports, and…
Deep Research
shepherdjerred/monorepo
This skill should be used when the user asks to "deep research", "research this topic", "investigate thoroughly", "do a deep dive on", "comprehensive research on", "find everything about", "survey…
Figma Use
shepherdjerred/monorepo
This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…
Fish Helper
shepherdjerred/monorepo
Current Fish shell scripting, functions, abbreviations, completions, variables, events, configuration, plugins, testing, and safety guidance.
Related
Works with
Categories
Questions about Grafana Helper
What does Grafana Helper do?
Use Grafana's GCX CLI for dashboards, datasources, Prometheus metrics, Loki logs, Tempo traces, alert rules, and Grafana resource operations. Grafana Helper is an agent skill from shepherdjerred/monorepo. Use Grafana's GCX CLI for dashboards, datasources, Prometheus metrics, Loki logs, Tempo traces, alert rules, and Grafana resource operations.
When should I use Grafana Helper?
Grafana Helper fits situations like: observability investigations; tasks that involve Monitoring and alerting.
How do I install Grafana Helper in Claude Code?
Run `npx skills add shepherdjerred/monorepo --skill grafana-helper -a claude-code`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/grafana-helper in shepherdjerred/monorepo) into .claude/skills/grafana-helper in your project. Claude Code loads it when a task matches its description.
How do I install Grafana Helper in Codex?
Run `npx skills add shepherdjerred/monorepo --skill grafana-helper -a codex`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/grafana-helper in shepherdjerred/monorepo) into .agents/skills/grafana-helper in your project. Codex loads it when a task matches its description.
Can I use Grafana Helper in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shepherdjerred/monorepo --skill grafana-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/grafana-helper, .gemini/skills/grafana-helper, .github/skills/grafana-helper and .opencode/skills/grafana-helper in your project.
What does Grafana Helper need to run?
Going by SKILL.md and its folder, Grafana Helper needs credentials named GRAFANA_API_KEY. Our summary lists: A credential in GRAFANA_API_KEY.
Does Grafana Helper access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Grafana Helper safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Grafana Helper use?
Grafana Helper is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Grafana Helper use?
About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Grafana Helper?
Skills that share tags, products or a category with Grafana Helper: Happy Infra Metrics and Grafana (slopus/happy, 24k stars), Syncmeta (pawurb/hotpath-rs, 1.9k stars), Optimize Slurm Topology (NVlabs/alpasim, 1.3k stars) and Dashboard Preview (m4r1k/Eneru, 149 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Grafana Helper?
shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 10, 2026.
Source: shepherdjerred/monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.