Use this skill as the default Grafana entrypoint for analytics work.
Core workflow
- 查找 relevant dashboard.
- Inspect panels 和 variables.
- Prefer reading 或 rerunning existing panel 之前 writing 新的 查询.
- Stay 读取-仅 unless 用户 explicitly asks 对于 creation 或 modification work.
默认 task order
1. Locate dashboard
Use dashboard search/list actions first.
Prefer this when the user asks things like:
- “这个指标在哪个看板里?”
- “有没有收入/LTV/注册转化相关看板?”
- “帮我找睡眠内容消费的图表”
2. Inspect dashboard structure
After finding a likely dashboard, read:
- dashboard title / uid
- panel 列表
- 变量 列表
- 默认 时间 range 或 刷新 settings 如果 可用
Do this before answering confidently. Many mistakes come from grabbing the wrong panel.
3. Inspect panel 查询
Before explaining a metric definition, extract the panel query/config.
Look for:
- datasource
- 查询 language / 查询 text
- ref IDs / multiple queries
- 变量 references
- transformations
Use this when the user asks:
- “这个图怎么算的?”
- “这个 DAU 的口径是什么?”
- “这个 panel 背后查的是哪张表/哪个 datasource?”
4. Rerun panel 查询
When the user wants the same chart under another condition, rerun the existing panel query with:
- 不同 时间 range
- 不同 variables
- 不同 格式 如果 supported
Prefer rerunning an existing panel over inventing a new query.
读取-仅 rules
- 做 不 创建 dashboards 在...中 skill.
- 做 不 更新 dashboards 在...中 skill.
- 做 不 删除 dashboards, panels, alerts, 或 annotations.
- 如果 task requires 新的 dashboard creation, hand off 到 build-oriented skill 或 explicit implementation flow.
Answering rules
When replying after Grafana reads, provide:
- answer 第一个
- panel/dashboard used
- 任何 键 变量 或 时间-range assumptions
- uncertainty 如果 panel 做 不 fully match 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:
- 搜索 dashboards
- 获取 dashboard details
- 列表 panels
- 获取 panel 查询
- 列表 variables
- run panel 查询
If an installed Grafana skill does not cover most of these, treat it as partial coverage and plan a local supplement.
当...时 Grafana 不 enough
Escalate beyond this skill when:
- 否 matching dashboard/panel exists
- 用户 needs arbitrary 新的 SQL 查询
- needed split 不 supported 由 existing variables
- 用户 asking 对于 新的 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 对于 concrete Grafana action matrix 和 MVP coverage
references/evaluation-notes.md 对于 为什么 rpe-grafana lightweight candidate 和 在哪里 likely falls short
Use this skill as the default Grafana entrypoint for analytics work.
Core workflow
- Find the relevant dashboard.
- Inspect its panels and variables.
- Prefer reading or rerunning an existing panel before writing a new query.
- 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