grafana-readonly

# 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