Grafana Readonly

Use this skill as the default Grafana entrypoint for analytics work.

Core workflow

1. Find the relevant dashboard.
2. Inspect its panels and variables.
3. Prefer reading or rerunning an existing panel before writing a new query.
4. Stay read-only unless the user explicitly asks for creation or modification work.

Default task order

1. Locate the dashboard

Use dashboard search/list actions first.

Prefer this when the user asks things like:

• “这个指标在哪个看板里？”
• “有没有收入/LTV/注册转化相关看板？”
• “帮我找睡眠内容消费的图表”

2. Inspect the dashboard structure

After finding a likely dashboard, read:

• dashboard title / uid
• panel list
• variable list
• default time range or refresh settings if available

Do this before answering confidently. Many mistakes come from grabbing the wrong panel.

3. Inspect the panel query

Before explaining a metric definition, extract the panel query/config.

Look for:

• datasource
• query language / query text
• ref IDs / multiple queries
• variable references
• transformations

Use this when the user asks:

• “这个图怎么算的？”
• “这个 DAU 的口径是什么？”
• “这个 panel 背后查的是哪张表/哪个 datasource？”

4. Rerun the panel query

When the user wants the same chart under another condition, rerun the existing panel query with:

• a different time range
• different variables
• a different format if supported

Prefer rerunning an existing panel over inventing a new query.

Read-only rules

• Do not create dashboards in this skill.
• Do not update dashboards in this skill.
• Do not delete dashboards, panels, alerts, or annotations.
• If the task requires new dashboard creation, hand off to a build-oriented skill or explicit implementation flow.

Answering rules

When replying after Grafana reads, provide:

• the answer first
• the panel/dashboard used
• any key variable or time-range assumptions
• uncertainty if the panel does not fully match the question

Do not dump raw Grafana JSON unless the user explicitly wants it.

Minimum action coverage

This skill is expected to support these read paths:

• search dashboards
• get dashboard details
• list panels
• get panel query
• list variables
• run panel query

If an installed Grafana skill does not cover most of these, treat it as partial coverage and plan a local supplement.

When Grafana is not enough

Escalate beyond this skill when:

• no matching dashboard/panel exists
• the user needs an arbitrary new SQL query
• the needed split is not supported by existing variables
• the user is asking for a new dashboard design

In those cases, switch to the analytics workflow skill and decide whether to use Grafana datasource queries or direct ClickHouse.

References

Read these only when needed:

• references/action-checklist.md for the concrete Grafana action matrix and MVP coverage
• references/evaluation-notes.md for why rpe-grafana is a lightweight candidate and where it likely falls short