Kansodata Grafana Authoring Operations

---

name: kansodata-grafana-authoring-operations description: Opera Grafana en OpenClaw con enfoque seguro: inspección real, diagnóstico, propuesta de cambios y aplicación solo cuando exista tooling habilitado y contexto suficiente.

---

Skill: kansodata-grafana-authoring-operations

Propósito

Esta skill guía al agente para:

inspeccionar estado real de Grafana,

diagnosticar dashboards y alerting,

generar/refactorizar JSON de dashboard,

proponer cambios seguros,

aplicar cambios solo cuando la herramienta write exista y esté habilitada.

Modos operativos

1. inspect_grafana

Objetivo: estado base de salud, dashboards, datasources, folders y alert rules.

Herramientas: grafana_health_check, grafana_list_dashboards, grafana_list_datasources, grafana_list_alert_rules, grafana_list_folders.

2. diagnose_dashboard

Objetivo: analizar dashboard por UID y detectar señales de rotura o deuda técnica.

Herramientas: grafana_get_dashboard, grafana_export_dashboard_json.

3. generate_dashboard_json

Objetivo: producir propuesta JSON para nuevo dashboard (sin aplicar en v1).

Regla: marcar salida como draft o review_ready según contexto disponible.

4. refactor_dashboard_json

Objetivo: proponer refactor lógico de dashboard existente.

Regla: usar estado actual leído desde Grafana antes de proponer.

5. propose_alert_rule

Objetivo: proponer reglas de alerta con justificación y riesgo.

Regla: no afirmar aplicabilidad sin verificar datasource/queries/contexto.

6. apply_dashboard_change

Objetivo: aplicar cambios en dashboard.

Estado v1: restringido; requiere herramienta write habilitada y gate activo.

7. apply_alerting_change

Objetivo: aplicar cambios de alerting.

Estado v1: restringido; requiere herramienta write habilitada y gate activo.

Niveles de confianza del contexto

grafana_state_confirmed: datos actuales obtenidos por tools read-only.

grafana_state_partial: parte del estado verificado, parte inferido.

grafana_state_assumed: no hay evidencia reciente del entorno.

Estados de madurez de salida

draft: propuesta preliminar; contexto insuficiente o ambiguo.

review_ready: propuesta consistente para revisión humana.

apply_ready: aplicable técnicamente con tooling/gates habilitados.

human_review_required: cambio sensible o riesgo no mitigado.

Reglas de comportamiento obligatorias

Leer estado actual antes de proponer cambios.

No inventar dashboards, folders, datasources ni alert rules.

No borrar recursos en v1.

No afirmar compatibilidad/viabilidad sin verificación real.

Proponer cambios como diff lógico cuando aplique.

Pedir operación write solo si existe tool habilitada y contexto suficiente.

Si falta contexto real, degradar salida a draft.

Degradación segura

Si falla una tool de lectura: reportar bloqueo y continuar con lo verificable.

Si el estado es parcial: marcar explícitamente incertidumbre.

Si se requiere write y no hay gate o tool habilitada: detener y emitir human_review_required.

Casos de uso

1. Listar dashboards disponibles. 2. Revisar dashboard por UID. 3. Exportar JSON para respaldo o versionado lógico. 4. Detectar dashboard roto (queries/panels inválidos observables en JSON). 5. Revisar alert rules existentes. 6. Proponer nueva alerta con justificación. 7. Preparar clon de dashboard como propuesta (sin aplicar en v1).