CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

grafana-dashboards

Create and manage production-ready Grafana dashboards for comprehensive system observability.

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/grafana-dashboards/SKILL.md

The canonical home for this skill is grafana-dashboards in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

40%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is rich in concrete, executable Grafana/PromQL examples, but it is padded with filler sections, lacks any real step-by-step workflow with validation, and its progressive-disclosure structure is illusory — all referenced bundle files are missing from the repository. It functions as a decent inline cheat-sheet rather than a well-structured skill.

Suggestions

Delete the vacuous 'Do not use this skill when', 'Instructions', and 'Purpose' sections and replace them with a concrete sequenced workflow (define metrics scope -> build dashboard JSON from the patterns -> validate with the Grafana API or `grafana cli` -> provision via YAML/Terraform) with an explicit validation checkpoint.

Ship the referenced files (assets/api-dashboard.json, assets/infrastructure-dashboard.json, assets/database-dashboard.json, references/dashboard-design.md, resources/implementation-playbook.md) or remove the dangling references; fix the 'resources/' vs 'references/' path inconsistency.

Deduplicate: keep only the panel-pattern snippets inline and move the full dashboard JSONs into the asset files, and drop the RED/USE definitions Claude already knows in favor of one-line pointers.

DimensionReasoningScore

Conciseness

Several sections are pure padding or re-teach what Claude already knows: a vacuous 'Do not use this skill when' ("The task is unrelated to grafana dashboards", "You need a different domain or tool outside this scope"), a generic 'Instructions' list ("Clarify goals, constraints, and required inputs", "Apply relevant best practices"), a 'Purpose' section restating the description, and spelled-out RED/USE method definitions. This matches 'Noticeably verbose; several unnecessary explanations or padded sections'. Not 3 because the padding is not incidental — roughly a quarter of the prose sections add nothing, and the full API dashboard JSON is inlined while also being promised in assets.

2 / 5

Actionability

The bulk is concrete, copy-paste-ready material: complete PromQL expressions, full panel JSON (stat, timeseries, table, heatmap), templating variables, alert rules, provisioning YAML, and Terraform/Ansible snippets. Not 5 because there are gaps — no end-to-end example of applying a dashboard via the Grafana API or grafana-cli, legacy 'graph' panel types mixed with modern ones, and every cited follow-up file (assets/*.json, references/dashboard-design.md, resources/implementation-playbook.md) is referenced but does not exist in the bundle. Not 3 because what is present is genuinely executable, not pseudocode.

4 / 5

Workflow Clarity

There is no real sequenced workflow for building or deploying a dashboard; the closest is the vague 'Instructions' list (clarify goals, apply best practices, validate outcomes) with no concrete steps and no validation checkpoints (no JSON-schema/API check, no test-deploy step), matching 'Rough sequence present but many gaps; steps poorly defined; validation absent'. Not 3 because even a loose step list for the core task is missing — the body is a reference compendium, and 'validate outcomes' is a placeholder rather than an implicit checkpoint. Not capped lower because no destructive/batch operation is involved.

2 / 5

Progressive Disclosure

The body cites 'resources/implementation-playbook.md', three 'assets/*.json' dashboards, and 'references/dashboard-design.md', but the bundle contains no assets/, references/, or scripts/ directories — every reference is dangling, so navigation leads nowhere. Meanwhile large content that belongs in those files (the full API dashboard JSON, panel-type specs) is inlined in SKILL.md, matching 'Minimal structure; content that clearly belongs in separate files is inlined'. Not 3 because the file split exists in name only: without the referenced files present, the disclosure structure is broken rather than merely imperfectly organized.

2 / 5

Total

10

/

20

Passed

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise and names a distinct, specific niche, but it reads as a one-line tagline rather than a trigger-rich description: it lacks any 'use when' guidance and misses natural keywords like monitoring, metrics, or alerting. Adding trigger phrases and one or two more concrete capabilities would lift most dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when creating or editing Grafana dashboards, visualizing Prometheus metrics, building SLO/monitoring dashboards, or provisioning dashboards as code.'

Replace buzzword padding ('production-ready', 'comprehensive system observability') with 2-3 more concrete capabilities (e.g., 'configure templated variables and alert rules, provision dashboards via Terraform/Ansible') to raise specificity.

Include the natural vocabulary users actually say — 'monitoring dashboard', 'metrics visualization', 'alerting' — to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ("Grafana dashboards") and two actions ("Create and manage"), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not score 2 because 'create and manage Grafana dashboards' is more concrete than 'Processes PDF files'-level genericity, and not score 4 because no further specific actions (visualize metrics, configure alerts, provision as code) are listed; 'production-ready' and 'comprehensive system observability' are buzzword padding, not capabilities.

3 / 5

Completeness

The 'what' is clear ('Create and manage production-ready Grafana dashboards') but there is no 'Use when...' clause or equivalent trigger guidance, which per the guidelines caps completeness at 3 ('Has a clear what but when is missing'). Not 4/5 because no use conditions are even weakly stated; not 2 because the 'what' half is concrete, not vague.

3 / 5

Trigger Term Quality

'Grafana dashboards' and 'observability' are relevant keywords a user might say, but common natural phrasings like 'monitoring', 'metrics', 'visualize Prometheus data', 'SLO', or 'dashboard alerts' are absent, matching 'Some relevant keywords but missing common variations or synonyms'. Not 4 because the keyword set is essentially one tool name plus a jargon word rather than 'good coverage with a few missing'.

3 / 5

Distinctiveness Conflict Risk

Grafana is a specific tool, so 'Grafana dashboards' carves a clear niche with minimal conflict risk, matching 'Mostly distinct; minor overlap risk with closely related skills' (e.g., a prometheus-configuration skill). Not 5 because the appended 'for comprehensive system observability' broadens the claimed scope beyond dashboard creation, slightly increasing overlap with general monitoring/observability skills.

4 / 5

Total

13

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/grafana-dashboards/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.