Agent skill · software engineering · google

cloud-monitoring-chart-generation

Generates Cloud Monitoring Server-Driven UI (SDUI) Widget and XyChart Protocol Buffer textprotos on Google Cloud from resolved PromQL or ListTimeSeries queries. Use when: - Generating valid google.monitoring.dashboard.v1.Widget textprotos, containing PrometheusQuery or TimeSeriesFilter datasets, for use with the Cloud Monitoring Dashboards API, gcloud CLI, or declarative dashboard definitions. - Synthesizing Server-Driven UI (SDUI) widget titles, axis labels, and plot types for Prometheus or ListTimeSeries queries. Don't use for: - Metric discovery or PromQL query generation. For those tasks, use the cloud-monitoring-metric-selection or cloud-monitoring-promql-query skills.

Why this skill is useful

Adds executable Python scripts for generating valid Google Cloud Monitoring widget Protocol Buffers from PromQL queries, which the AI cannot generate on its own.

What it needs

Requires pip, python3 installed locally. About 6k tokens when loaded. Last updated 2026-08-06. 15,831 stars on the source repository.

What this skill does

Cloud Monitoring Chart Generation Skill (cloud-monitoring-chart-generation) Transforms PromQL or ListTimeSeries JSON request payloads and metric metadata into valid Server-Driven UI (SDUI) google.monitoring.dashboard.v1.Widget Protocol Buffer textprotos. These generated textprotos are designed to be ingested by the Cloud Monitoring Dashboards API, gcloud CLI, or declarative dashboard provisioning pipelines. [!IMPORTANT] Preferred API & Mutually Exclusive Queries: - API Preference: Always prefer generating ListTimeSeries (timeseriesfilter) configurations for widgets over PromQL, unless the user explicitly requested PromQL or the metric math strictly requires it. - Mutually Exclusive: A widget dataset timeseriesquery must contain EITHER a timeseriesfilter OR a prometheusquery. You must never populate both fields in the same dataset simultaneously. - Strict Passthrough: You MUST copy the provided PromQL query or ListTimeSeries JSON exact filter string character-for-character. DO NOT invent, rewrite, or modify the queries under any circumstances. [!CAUTION] CRITICAL EXECUTION & WORKING DIRECTORY RULES: - DO NOT CHANGE WORKING DIRECTORY: Keep your working directory at your workspace root. Do NOT cd into skill subdirectories. - NO DISCOVERY OR SEARCH RULE: The metric descriptor, PromQL query, ListTimeSeries JSON payload, unit, and resource type are ALWAYS present in the conversation context. NEVER run file or codebase search tools, like grep, find, directory listings, or codebase queries, to discover metric metadata or inspect repository structures. - SCRIPT EXECUTION: Execute the bundled Python scripts directly using python3. - OUTPUT GENERATION: The assemblewidgetproto script automatically generates a unique UUID-based filename to prevent parallel execution collisions. It will print the generated filename to standard error strongly prefixed with "Wrote widget textproto to:". …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills google/cloud-monitoring-chart-generation

View the source on GitHub

Browse the @skills marketplace