Agent skill

Cxas Configurable Dashboards

by GoogleCloudPlatform in GoogleCloudPlatform/cxas-scrapi

Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards.

Apache-2.0Auto-check passedDatabases

Install Cxas Configurable Dashboards

skills CLI
$ npx skills add GoogleCloudPlatform/cxas-scrapi --skill cxas-configurable-dashboards -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GoogleCloudPlatform/cxas-scrapi cxas-configurable-dashboards --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/cxas-scrapi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cxas-configurable-dashboards .claude/skills/cxas-configurable-dashboards && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cxas-configurable-dashboards
GitHub stars
106
Token cost
~1.8k tokens
SKILL.md length
313 words
Files
6 (incl. scripts, references)
Skills in repo
14
Repo updated
First seen
Licence
Apache-2.0

At a glance

Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards.

  • Works in 4 steps: Overview & Declarative YAML Schema → Vega-Lite & SQL Recipes → Step-by-Step Workflow → …
  • Users want to define multi-tab analytics dashboards
  • SKILL.md covers 1. Overview & Declarative YAML…, 2. Vega-Lite & SQL Recipes, 3. Step-by-Step Workflow and 4. CLI Command Reference
  • Runs Python scripts from its folder; calls uv

What it does

Cxas Configurable Dashboards is an agent skill from GoogleCloudPlatform/cxas-scrapi. Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards. Use when users want to define multi-tab analytics dashboards, configure Vega-Lite charts and SQL queries, maintain declarative dashboards.yaml configurations, or synchronize dashboards to GCP projects.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/dashboard_sql_cookbook.md`, `references/design.md` and `references/schema.json`).

It sits in Databases, covering SQL. It works with Google Cloud, SQL and Google BigQuery. The repository describes itself as: A powerful Python API, CLI, and set of Agent Skills for CX Agent Studio to automate, evaluate, and scale your agents with ease. The licence is Apache-2.0.

When your agent uses it

  • Users want to define multi-tab analytics dashboards
  • Configure Vega-Lite charts and SQL queries
  • Maintain declarative dashboards.yaml configurations
  • Synchronize dashboards to GCP projects

Example prompts

  • “/cxas-configurable-dashboards”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Overview & Declarative YAML Schema
  2. Vega-Lite & SQL Recipes
  3. Step-by-Step Workflow
  4. CLI Command Reference

What it can do on your machine

Read from SKILL.md and the folder at commit ffba639. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cxas Configurable Dashboards loads about 1.8k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 313 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from GoogleCloudPlatform/cxas-scrapi at commit ffba639, republished under its Apache-2.0 licence (© GoogleCloudPlatform). 313 words, ~1,756 tokens.

Download SKILL.mdSave it as .claude/skills/cxas-configurable-dashboards/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
cxas-configurable-dashboards
description
Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards. Use when users want to define multi-tab analytics dashboards, configure Vega-Lite charts and SQL queries, maintain declarative dashboards.yaml configurations, or synchronize dashboards to GCP projects.

CCAI Insights Configurable Dashboards Skill

This skill guides you in authoring, refining, validating, and synchronizing Contact Center AI (CCAI) Insights Configurable Dashboards.

CCAI Insights Configurable Dashboards allow users to build customizable, multi-tab reporting views with rich visualization widgets (Score Cards, Bar/Line charts, Pie charts, Tables, Sankey diagrams) powered by Vega-Lite specifications and SQL queries against conversation metrics.


1. Overview & Declarative YAML Schema

Dashboards are defined declaratively in dashboards.yaml:

yaml
version: "1.0"
project_id: "your-gcp-project-id"
location: "us-central1"

dashboards:
  - dashboard_id: "executive_kpis"
    display_name: "Executive Contact Center KPIs"
    description: "High-level summary of inbound call volumes, virtual agent containment, and quality."
    date_range:
      relative:
        quantity: 7
        unit: "DAY"

    root_container:
      display_name: "Root"
      widgets:
        - container:
            display_name: "Overview Tab"
            description: "Operational summary metrics"
            widgets:
              # Tile 1: Total Volume Scorecard
              - chart:
                  display_name: "Total Conversations"
                  chart_visualization_type: "SCORE_CARD"
                  width: 4
                  height: 3
                  data_source:
                    generative_insights:
                      sql_query: "SELECT COUNT(DISTINCT conversation_id) AS total_calls FROM conversations"
                      chart_spec:
                        mark: "text"
                        encoding:
                          text: {field: "total_calls", type: "quantitative"}

              # Tile 2: Top Contact Drivers Bar Chart
              - chart:
                  display_name: "Top Contact Drivers"
                  chart_visualization_type: "BAR"
                  width: 8
                  height: 6
                  data_source:
                    generative_insights:
                      sql_query: >-
                        SELECT issue_category, COUNT(1) AS volume
                        FROM conversations
                        WHERE issue_category IS NOT NULL
                        GROUP BY 1
                        ORDER BY volume DESC
                        LIMIT 10
                      chart_spec:
                        mark: "bar"
                        encoding:
                          x: {field: "volume", type: "quantitative", title: "Calls"}
                          y: {field: "issue_category", type: "nominal", sort: "-x", title: "Category"}
Core Structural Requirements
  1. Root Container Constraint (ValidateDashboardStructure):
    • Every dashboard must have a root_container.
    • Direct widgets in root_container must all be Container widgets representing tabs/sections.
  2. Widgets within Tabs:
    • Each tab container contains child widgets (container for sub-grouping, chart for visualizations, or chart_reference for linked charts).
  3. Chart Visualizations:
    • chart_visualization_type: SCORE_CARD, BAR, LINE, AREA, PIE, SCATTER, TABLE, SANKEY.
    • data_source: Contains generative_insights with sql_query and Vega-Lite chart_spec.

2. Vega-Lite & SQL Recipes

Refer to:

Common Patterns
  • Scorecard (Single KPI):
    yaml
    chart_visualization_type: "SCORE_CARD"
    data_source:
      generative_insights:
        sql_query: "SELECT COUNT(1) AS total FROM conversations"
        chart_spec:
          mark: "text"
          encoding:
            text: {field: "total", type: "quantitative"}
  • Time Series Trend (Line Chart):
    yaml
    chart_visualization_type: "LINE"
    data_source:
      generative_insights:
        sql_query: "SELECT DATE(start_time) AS date, COUNT(1) AS calls FROM conversations GROUP BY 1"
        chart_spec:
          mark: "line"
          encoding:
            x: {field: "date", type: "temporal"}
            y: {field: "calls", type: "quantitative"}

3. Step-by-Step Workflow

Step 1: Ingest Requirements
  • Ask the user what operational metrics, KPIs, or tabs they need (e.g. Agent QA performance, Containment %, Top Contact Drivers, CSAT trends).
  • Identify the target GCP project ID and location.
Show full SKILL.md (151 more words)Show less
Step 2: Draft or Edit Declarative YAML
  • Create or update dashboards.yaml in the user's workspace.
  • Structure tabs inside root_container.widgets.
  • Add scorecards, bar charts, and line charts with matching Vega-Lite specs and SQL queries.
Step 3: Compare with Active Remote Dashboards (diff)

Run diff to preview additions, modifications, and deletions:

bash
uv run cxas insights diff-dashboards --file dashboards.yaml
Step 4: Dry-Run Deploy

Verify planned operations against GCP without mutating resources:

bash
uv run cxas insights push-dashboards --file dashboards.yaml --dry-run
Step 5: Push to GCP

Deploy new and updated dashboards to Contact Center AI Insights:

bash
uv run cxas insights push-dashboards --file dashboards.yaml

If deleting obsolete remote dashboards:

bash
uv run cxas insights push-dashboards --file dashboards.yaml --force

4. CLI Command Reference

  • Pull Remote Dashboards:
    bash
    uv run cxas insights pull-dashboards --parent projects/PROJECT_ID/locations/LOCATION [--out dashboards.yaml]
  • Diff Dashboards:
    bash
    uv run cxas insights diff-dashboards --file dashboards.yaml
  • Push / Sync Dashboards:
    bash
    uv run cxas insights push-dashboards --file dashboards.yaml [--dry-run] [--force]
  • List Dashboards:
    bash
    uv run cxas insights list-dashboards --parent projects/PROJECT_ID/locations/LOCATION
  • Get Dashboard:
    bash
    uv run cxas insights get-dashboard --dashboard-name projects/PROJECT_ID/locations/LOCATION/dashboards/DASHBOARD_ID
  • Delete Dashboard:
    bash
    uv run cxas insights delete-dashboard --dashboard-name projects/PROJECT_ID/locations/LOCATION/dashboards/DASHBOARD_ID

© GoogleCloudPlatform, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in .agents/skills/cxas-configurable-dashboards of GoogleCloudPlatform/cxas-scrapi.

  • SKILL.md
  • references/dashboard_sql_cookbook.md
  • references/design.md
  • references/schema.json
  • references/vega_cookbook.md
  • scripts/sync_dashboards.py

Open the folder on GitHubat commit ffba639

Compare with similar skills

Cxas Configurable Dashboards next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cxas Configurable Dashboards compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cxas Configurable Dashboards this skillGoogleCloudPlatform/cxas-scrapi106—~1.8kAutomated safety check: PassApache-2.0
Imaging Data CommonsK-Dense-AI/scientific-agent-skills48k1 repos~7.8kAutomated safety check: PassMIT
Bigquery Observabilitygoogle/skills21k—~3.5kAutomated safety check: PassApache-2.0
Bigquery Optimizationgoogle/skills21k—~2kAutomated safety check: PassApache-2.0
Cloud Monitoring Metric Selectiongoogle/skills21k—~2.4kAutomated safety check: PassApache-2.0
dbt Snowflake to BigQuery Translatorgoogle/skills21k—~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Imaging Data Commons

    K-Dense-AI/scientific-agent-skills

    Queries and downloads public cancer imaging data from NCI Imaging Data Commons.

    48k GitHub starsUsed in 1 repo~7.8k tokens
    DatabasesAuto-check passed
  • Official

    Provides data-retrieval best practices, tool selection guidance, and performant SQL query syntax for BigQuery telemetry across INFORMATIONSCHEMA, Cloud Monitoring, and the REST API.

    21k GitHub stars~3.5k tokensUpdated today
    DatabasesAuto-check passed
  • Official

    Provides workflows to optimize BigQuery environments (capacity planning, editions), storage assets (partitioning, clustering, storage lifecycles, billing models), and SQL queries.

    21k GitHub stars~2k tokensUpdated today
    DatabasesAuto-check passed
  • Official

    Retrieve, query, and identify relevant Google Cloud Monitoring metric descriptors for a GCP service or resource (such as Compute Engine, Spanner, BigQuery, Cloud Run, Cloud SQL, Pub/Sub, Cloud…

    21k GitHub stars~2.4k tokensUpdated today
    DatabasesAuto-check passed
  • Translates Snowflake dbt SQL models into standardized BigQuery SQL, keeping Jinja constructs and tracking progress in a migration tasks file.

    21k GitHub stars~2.7k tokensUpdated today
    DatabasesAuto-check passed
  • Official

    Stores, retrieves, and manages data as objects in Cloud Storage on Google Cloud (also known colloquially as GCS) buckets.

    21k GitHub stars~2.8k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from GoogleCloudPlatform/cxas-scrapi

All 14 skills in this repo
  • Cxas Agent Foundry

    GoogleCloudPlatform/cxas-scrapi

    End-to-end GECX/CXAS/CES conversational agent lifecycle -- build agents from requirements (PRD-to-agent), create and run evals (goldens, simulations, tool tests, callback tests), debug failures, and…

    106 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Cxas Autolabel Rules

    GoogleCloudPlatform/cxas-scrapi

    Author, validate, and manage Contact Center AI (CCAI) Insights Autolabeling Rules.

    106 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Cxas Dfcx Migration

    GoogleCloudPlatform/cxas-scrapi

    Migrate Dialogflow CX (DFCX) agents to CXAS (Customer Experience Agent Studio) agents.

    106 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Cxas Loss Analysis

    GoogleCloudPlatform/cxas-scrapi

    Retrieves non-contained CCAI Insights conversations (losses), uses agent intelligence to cluster them into common failure patterns, and generates a markdown report.

    106 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Cxas Sim Eval

    GoogleCloudPlatform/cxas-scrapi

    Converts CXAS golden evaluations to SCRAPI SimulationEvals test cases.

    106 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Cxas Composite Voice Agent Optimizer

    GoogleCloudPlatform/cxas-scrapi

    Audits, optimizes, and remediates CXAS agent configurations for Gemini Composite V1 voice naturalness, persona styling, and multi-language coverage directly in local workspaces with cxas-scrapi.

    106 GitHub stars~10k tokensUpdated today
    Auto-check passed

Categories

Questions about Cxas Configurable Dashboards

What does Cxas Configurable Dashboards do?

Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards. Cxas Configurable Dashboards is an agent skill from GoogleCloudPlatform/cxas-scrapi. Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards.

When should I use Cxas Configurable Dashboards?

Cxas Configurable Dashboards fits situations like: users want to define multi-tab analytics dashboards; configure Vega-Lite charts and SQL queries; maintain declarative dashboards.yaml configurations; synchronize dashboards to GCP projects.

How do I install Cxas Configurable Dashboards in Claude Code?

Run `npx skills add GoogleCloudPlatform/cxas-scrapi --skill cxas-configurable-dashboards -a claude-code`. Or copy the skill folder (.agents/skills/cxas-configurable-dashboards in GoogleCloudPlatform/cxas-scrapi) into .claude/skills/cxas-configurable-dashboards in your project. Claude Code loads it when a task matches its description.

How do I install Cxas Configurable Dashboards in Codex?

Run `npx skills add GoogleCloudPlatform/cxas-scrapi --skill cxas-configurable-dashboards -a codex`. Or copy the skill folder (.agents/skills/cxas-configurable-dashboards in GoogleCloudPlatform/cxas-scrapi) into .agents/skills/cxas-configurable-dashboards in your project. Codex loads it when a task matches its description.

Can I use Cxas Configurable Dashboards in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GoogleCloudPlatform/cxas-scrapi --skill cxas-configurable-dashboards -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cxas-configurable-dashboards, .gemini/skills/cxas-configurable-dashboards, .github/skills/cxas-configurable-dashboards and .opencode/skills/cxas-configurable-dashboards in your project.

What does Cxas Configurable Dashboards need to run?

Going by SKILL.md and its folder, Cxas Configurable Dashboards needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Cxas Configurable Dashboards access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cxas Configurable Dashboards safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Cxas Configurable Dashboards use?

Cxas Configurable Dashboards is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cxas Configurable Dashboards use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.7k tokens, read only when the agent opens those files.

What are the alternatives to Cxas Configurable Dashboards?

Skills that share tags, products or a category with Cxas Configurable Dashboards: Imaging Data Commons (K-Dense-AI/scientific-agent-skills, 48k stars), Bigquery Observability (google/skills, 21k stars), Bigquery Optimization (google/skills, 21k stars) and Cloud Monitoring Metric Selection (google/skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cxas Configurable Dashboards?

GoogleCloudPlatform (a GitHub organization) maintains it in GoogleCloudPlatform/cxas-scrapi, which has 106 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 6, 2026.

Source: GoogleCloudPlatform/cxas-scrapi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.