# Cloud monitoring chart generation

> Cloud monitoring chart generation is an open-source agent skill for developer tools. Builds Cloud Monitoring dashboard chart definitions from PromQL or ListTimeSeries queries. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/google/skills/tree/main/skills/cloud/cloud-monitoring-chart-generation
- **Repository:** https://github.com/google/skills
- **GitHub stars:** 24,379
- **License:** Apache-2.0
- **Skill name:** cloud-monitoring-chart-generation
- **Collection:** https://github.com/google/skills
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

This skill turns an existing PromQL or ListTimeSeries query, plus metric metadata such as display name, resource type and unit, into a Cloud Monitoring widget written as a google.monitoring.dashboard.v1.Widget textproto. The output is meant for the Dashboards API, the gcloud CLI or declarative dashboard provisioning. The agent is told to keep the query text unchanged and to prefer ListTimeSeries filters over PromQL unless PromQL is requested or needed for the math.

The workflow has three stages. A Python script produces baseline titles and unit candidates, the agent then chooses a title, axis label, plot type and UCUM unit, and a second script assembles the textproto with a unique filename. A validator script then checks that the query substring and unit survived unchanged, with up to two retries on schema errors. If scripts cannot run in the sandbox, the agent writes the textproto directly and gives the user commands to run locally.

The skill needs Python 3 and the packages listed in its requirements file. It does not discover metrics or write queries; those tasks are handled by separate companion skills.

## When your agent uses it

> 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.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Runs Python scripts](https://github.com/google/skills/tree/HEAD/skills/cloud/cloud-monitoring-chart-generation)
- [No network calls found in its scripts](https://github.com/google/skills/tree/HEAD/skills/cloud/cloud-monitoring-chart-generation)
- [License: Apache-2.0](https://github.com/google/skills/tree/HEAD/skills/cloud/cloud-monitoring-chart-generation)

## Features

- **Widget textproto assembly:** Produces a dashboard Widget textproto with an xy chart from a PromQL or ListTimeSeries query.
- **Query passthrough checks:** Validates that the original query or filter string and unit are preserved in the output.
- **Unit derivation rules:** Maps rate, ratio and aggregation expressions to UCUM unit strings for the chart.
- **Title and axis labeling:** Generates concise widget titles and y-axis labels without unit suffixes.
- **Plot type selection:** Defaults to line charts and uses stacked area for distribution queries or when requested.
- **Sandbox fallback:** Provides a way to output the textproto directly with local verification commands if scripts fail.

## Good for

- Create a dashboard chart for a Compute Engine CPU utilization metric
- Turn a PromQL histogram quantile query into a dashboard widget
- Generate a Cloud Monitoring widget textproto for a Dashboards API import
- Add a stacked area chart for a distribution metric to a dashboard file

## Install

### Claude Code

Copy the skill folder to `~/.claude/skills/cloud-monitoring-chart-generation` to use it in all your projects:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/cloud-monitoring-chart-generation &&
cp -R "$tmp/skills/cloud/cloud-monitoring-chart-generation" ~/.claude/skills/cloud-monitoring-chart-generation &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/cloud-monitoring-chart-generation` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/cloud-monitoring-chart-generation` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/cloud-monitoring-chart-generation &&
cp -R "$tmp/skills/cloud/cloud-monitoring-chart-generation" ~/.agents/skills/cloud-monitoring-chart-generation &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/cloud-monitoring-chart-generation` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/cloud-monitoring-chart-generation` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/cloud-monitoring-chart-generation &&
cp -R "$tmp/skills/cloud/cloud-monitoring-chart-generation" ~/.cursor/skills/cloud-monitoring-chart-generation &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/cloud-monitoring-chart-generation` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/google/skills.git --path skills/cloud/cloud-monitoring-chart-generation
```

Or copy the folder to `~/.gemini/skills/cloud-monitoring-chart-generation` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/cloud-monitoring-chart-generation`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/cloud-monitoring-chart-generation &&
cp -R "$tmp/skills/cloud/cloud-monitoring-chart-generation" ~/.copilot/skills/cloud-monitoring-chart-generation &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/cloud-monitoring-chart-generation` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/google/skills.git
```

Then copy `skills/skills/cloud/cloud-monitoring-chart-generation` into your agent's skills folder as `cloud-monitoring-chart-generation`. Agents that support SKILL.md read one folder per skill.

## FAQ

### Which clients can use this skill?

It follows the shared agent skills format and is listed for all supported clients, since the content does not tie it to a specific one.

### Does it discover metrics or write PromQL queries?

No. The skill says metric discovery and PromQL generation belong to the cloud-monitoring-metric-selection and cloud-monitoring-promql-query skills.

### What does it need to run?

It uses Python 3 scripts and requires installing the packages in scripts/requirements.txt.

### Does it change the query I supply?

The instructions say to copy the PromQL or filter string exactly and to run a validator that checks for unmodified query text.

### How do I install Cloud monitoring chart generation in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/cloud-monitoring-chart-generation to use it in all your projects, or to .claude/skills/cloud-monitoring-chart-generation in one project.

### Does Cloud monitoring chart generation run scripts?

Yes. It runs Python scripts. No network calls were found in its scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Cloud monitoring chart generation?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Cloud monitoring chart generation?

The closest alternatives to Cloud monitoring chart generation are UI widget developer, Qdrant monitoring setup, Skill creator and PR dashboard.

## Where this comes from

- Description: from the skill's own SKILL.md.

## Alternatives

- [UI widget developer](https://ai-powered.com/skills/ui-widget-developer): UI widget developer is an open-source agent skill for developer tools.
- [Qdrant monitoring setup](https://ai-powered.com/skills/qdrant-monitoring-setup): Qdrant monitoring setup is an open-source agent skill for knowledge and memory.
- [Skill creator](https://ai-powered.com/skills/skill-creator): Skill creator is a free agent skill for ai models and llm tooling.
- [PR dashboard](https://ai-powered.com/skills/pr-dashboard): PR dashboard is an open-source agent skill for analytics and data.

---
Source: https://ai-powered.com/skills/cloud-monitoring-chart-generation
