Agent skill

Grafana Dashboard

by pando85 in pando85/kaniop

Improve and validate the Kaniop Grafana dashboard against repository metrics and the grigri live cluster.

AGPL-3.0Auto-check passedDevOps & Cloud

Install Grafana Dashboard

skills CLI
$ npx skills add pando85/kaniop --skill grafana-dashboard -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pando85/kaniop grafana-dashboard --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pando85/kaniop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/grafana-dashboard .claude/skills/grafana-dashboard && rm -rf skills-src

Use ~/.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/

Facts

Skill name
grafana-dashboard
GitHub stars
132
Token cost
~987 tokens
SKILL.md length
437 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Improve and validate the Kaniop Grafana dashboard against repository metrics and the grigri live cluster.

  • Works in 3 steps: An explore agent inventories metric… → A second agent reviews the proposed… → Keep edits, MCP validation, and final…
  • Changing dashboard panels
  • SKILL.md covers Source of truth, Orchestration, Workflow and PromQL rules, plus 1 more section
  • Calls make and helm

What it does

Grafana Dashboard is an agent skill from pando85/kaniop. Improve and validate the Kaniop Grafana dashboard against repository metrics and the grigri live cluster. Use when changing dashboard panels, PromQL, variables, units, legends, or layout in charts/kaniop/files/dashboards/kaniop.json.

Its SKILL.md is about 990 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 and Container orchestration. It works with Grafana, Prometheus and Kubernetes. The repository describes itself as: Kubernetes operator for managing Kanidm. The licence is AGPL-3.0.

When your agent uses it

  • Changing dashboard panels
  • Layout in charts/kaniop/files/dashboards/kaniop.json

Example prompts

  • “/grafana-dashboard”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. An explore agent inventories metric definitions, label sets, dashboard queries, and tests.
  2. A second agent reviews the proposed PromQL and panel design.
  3. Keep edits, MCP validation, and final browser acceptance in the orchestrator.

What it can do on your machine

Read from SKILL.md and the folder at commit 772eb05. 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

    Shell commands in SKILL.md call:

    • make
    • helm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use helm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Grafana Dashboard loads about 987 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 437 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~987

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 pando85/kaniop at commit 772eb05, republished under its AGPL-3.0 licence (© pando85). 437 words, ~987 tokens.

Download SKILL.mdSave it as .claude/skills/grafana-dashboard/SKILL.md (or your agent's skills folder).
name
grafana-dashboard
description
Improve and validate the Kaniop Grafana dashboard against repository metrics and the grigri live cluster. Use when changing dashboard panels, PromQL, variables, units, legends, or layout in charts/kaniop/files/dashboards/kaniop.json.

Kaniop Grafana Dashboard

Use this workflow for every dashboard change. Do not finish until both Grafana MCP query validation and Passless-managed visual validation succeed.

Source of truth

  • Dashboard: charts/kaniop/files/dashboards/kaniop.json
  • Metrics: libs/operator/src/metrics.rs, libs/k8s-util/src/metrics.rs
  • Provisioning: charts/kaniop/templates/dashboard-configmap.yaml
  • Helm tests: charts/kaniop/tests/dashboard-configmap_test.yaml
  • Live Grafana: grafana.grigri.cloud
  • Live datasource: discover it with grafana-grigri_list_datasources; never assume a UID

Orchestration

Delegate independent discovery to subagents:

  1. An explore agent inventories metric definitions, label sets, dashboard queries, and tests.
  2. A second agent reviews the proposed PromQL and panel design.
  3. Keep edits, MCP validation, and final browser acceptance in the orchestrator.

Workflow

  1. Inventory metric names and labels from Rust before editing.
  2. Discover live Kaniop metrics with grafana-grigri_list_prometheus_metric_names using ^kaniop_.*.
  3. Confirm labels and values with grafana-grigri_list_prometheus_label_names and grafana-grigri_list_prometheus_label_values.
  4. Compare repository metrics with live metrics. Do not add a panel that has neither live data nor an explicit reason to document an expected absent series.
  5. Edit the provisioned dashboard. Preserve its stable uid; omit the Grafana database-level id.
  6. Validate every changed PromQL expression with grafana-grigri_query_prometheus over a representative live time range.
  7. Upload a development copy through grafana-grigri_update_dashboard:
    • remove id
    • use UID kaniop-dev
    • set title to Kaniop — DEV VALIDATION
    • set overwrite: true
    • leave the development copy in place for later iterations
  8. Retrieve the uploaded copy with grafana-grigri_get_dashboard_summary and grafana-grigri_get_dashboard_panel_queries; verify panel count, datasource, and exact expressions.
  9. Run helm unittest charts/kaniop, make lint, and make test.
  10. Use the passless-agent skill and its required profile checks. Launch the Passless-managed browser, connect through Playwright MCP, log in to grafana.grigri.cloud, open /d/kaniop-dev, and inspect the rendered dashboard. Never expose credentials, cookies, CDP data, or tokens.
  11. Verify that panels load, variables populate, legends are readable, units are correct, no query errors appear, and absent data is explainable by cluster activity rather than an invalid query.
Show full SKILL.md (138 more words)Show less

PromQL rules

  • Counters: use rate(...[$interval]) for throughput and increase(...[$interval]) for interval totals.
  • Histograms: use histogram_quantile(q, sum by (<labels>, le) (rate(..._bucket[$interval]))).
  • Reconcile metrics: preserve the controller filter and grouping where relevant.
  • Kubernetes API request metrics: the application emits endpoint, but Prometheus may rename it to exported_endpoint when the scrape target already has an endpoint label. Discover the live label before choosing it.
  • Avoid division by zero in mean calculations when the denominator can be absent.
  • Use explicit legend formats for multi-label series.

Acceptance checklist

  • Dashboard JSON parses.
  • Every metric and label is confirmed in code.
  • Changed queries execute successfully through grafana-grigri.
  • The dev dashboard exists and its stored queries match the repository.
  • Helm tests, lint, and tests pass.
  • Passless-managed browser verification succeeds against the real grigri cluster.
  • The repository dashboard keeps its production UID and contains no environment credentials.

© pando85, AGPL-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 .opencode/skills/grafana-dashboard of pando85/kaniop.

Open the folder on GitHubat commit 772eb05

Compare with similar skills

Grafana Dashboard 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.

Grafana Dashboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Grafana Dashboard this skillpando85/kaniop132—~987Automated safety check: PassAGPL-3.0
Alloygrafana/skills282—~1.3kAutomated safety check: PassApache-2.0
Beylagrafana/skills282—~1.1kAutomated safety check: PassApache-2.0
Fleet Managementgrafana/skills282—~1.3kAutomated safety check: PassApache-2.0
Mimirgrafana/skills282—~1.2kAutomated safety check: PassApache-2.0
Signozqjoly/GitOps112—~6.1kAutomated safety check: PassWTFPL

Similar skills

  • Alloy

    grafana/skills

    Official

    Build a unified telemetry pipeline with Grafana Alloy — one OpenTelemetry-compatible binary that collects metrics, logs, traces, and profiles and ships to Grafana Cloud / Prometheus / Loki / Tempo /…

    282 GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Beyla

    grafana/skills

    Official

    Auto-instrument an application's HTTP / gRPC / DB traffic with Grafana Beyla eBPF — no code changes, no SDK, no restart.

    282 GitHub stars~1.1k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Fleet Management

    grafana/skills

    Official

    Manage a fleet of Grafana Alloy collectors with Fleet Management — author Alloy pipelines once, target them via attribute matchers (env="production", regex region=~"us-."), push remotely via OpAMP…

    282 GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Mimir

    grafana/skills

    Official

    Stand up Grafana Mimir for horizontally scalable, multi-tenant, long-term Prometheus + OTLP metrics storage.

    282 GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Signoz

    qjoly/GitOps

    Manage the self-hosted SigNoz observability stack in this GitOps repo.

    112 GitHub stars~6.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Prometheus Grafana

    BagelHole/DevOps-Security-Agent-Skills

    Set up metrics collection and visualization with Prometheus and Grafana.

    1.2k GitHub stars~2.5k tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed

More from pando85/kaniop

  • Document Learnings

    pando85/kaniop

    Guidelines for documenting reusable patterns discovered during work.

    132 GitHub stars~501 tokensUpdated today
    Auto-check passed
  • Helm Chart

    pando85/kaniop

    Guidelines for modifying the Helm chart. An agent skill from pando85/kaniop.

    132 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Kaniop Development

    pando85/kaniop

    Kaniop architecture, Rust controller conventions, commands, testing, and repository workflows.

    132 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Release

    pando85/kaniop

    Prepare and publish a new release. An agent skill from pando85/kaniop.

    132 GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Grafana Dashboard

What does Grafana Dashboard do?

Improve and validate the Kaniop Grafana dashboard against repository metrics and the grigri live cluster. Grafana Dashboard is an agent skill from pando85/kaniop. Improve and validate the Kaniop Grafana dashboard against repository metrics and the grigri live cluster.

When should I use Grafana Dashboard?

Grafana Dashboard fits situations like: changing dashboard panels; layout in charts/kaniop/files/dashboards/kaniop.json.

How do I install Grafana Dashboard in Claude Code?

Run `npx skills add pando85/kaniop --skill grafana-dashboard -a claude-code`. Or copy the skill folder (.opencode/skills/grafana-dashboard in pando85/kaniop) into .claude/skills/grafana-dashboard in your project. Claude Code loads it when a task matches its description.

How do I install Grafana Dashboard in Codex?

Run `npx skills add pando85/kaniop --skill grafana-dashboard -a codex`. Or copy the skill folder (.opencode/skills/grafana-dashboard in pando85/kaniop) into .agents/skills/grafana-dashboard in your project. Codex loads it when a task matches its description.

Can I use Grafana Dashboard 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 pando85/kaniop --skill grafana-dashboard -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-dashboard, .gemini/skills/grafana-dashboard, .github/skills/grafana-dashboard and .opencode/skills/grafana-dashboard in your project.

What does Grafana Dashboard need to run?

Going by SKILL.md and its folder, Grafana Dashboard needs the command-line tools its instructions call (make and helm).

Does Grafana Dashboard 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 Dashboard 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 Dashboard use?

Grafana Dashboard is published under the AGPL-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 Dashboard use?

About 987 tokens (SKILL.md is roughly 3.9k 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 Dashboard?

Skills that share tags, products or a category with Grafana Dashboard: Alloy (grafana/skills, 282 stars), Beyla (grafana/skills, 282 stars), Fleet Management (grafana/skills, 282 stars) and Mimir (grafana/skills, 282 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Grafana Dashboard?

pando85 (a GitHub user) maintains it in pando85/kaniop, which has 132 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

Source: pando85/kaniop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.