gcx-demo

Runs a narrated read-only demo tour of gcx across Grafana Cloud product areas.

1|Updated May 25, 2020
One-click install
npx skills add https://github.com/titaneric/dotfiles --skill gcx-demo-titaneric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gcx-demo
Source: https://github.com/titaneric/dotfiles/tree/main/dot_agents/skills/gcx-demo
Command: npx skills add https://github.com/titaneric/dotfiles --skill gcx-demo-titaneric

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Presenting the breadth of a Grafana Cloud CLI to customers or colleagues requires knowing which commands to run, in what order, and how to narrate the results without risking any changes to the stack. This Skill automates a guided, strictly read-only demo tour of gcx so presenters can showcase real live data without memorizing commands or fearing accidental mutations. ## Core Features & Use Cases - Read-only showcase: Runs only list, get, query, and status commands across resources, datasources, metrics, logs, traces, SLOs, alerts, synthetic monitoring, IRM, k6, and fleet — nothing is created, modified, or deleted. - Adaptive narration: Discovers what is actually on the stack first, then emphasizes the interesting findings rather than reciting a fixed script, with graceful degradation when a command fails or a feature is unavailable. - Use Case: A solutions engineer says "demo gcx" before a customer call. The Skill verifies the active context, tours dashboards, live signals, firing alerts, and on-call schedules, then closes with a summary of what was shown. ## Quick Start Ask the assistant to run a gcx demo tour, optionally specifying a context with --context <name>.

Frequently Asked Questions about gcx-demo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a read-only demo of the gcx CLI?

Invoke the demo with a phrase like "demo gcx" or "/gcx-demo", optionally passing --context <name>. The tour verifies the active context first, then runs only list, get, query, and status commands across Grafana Cloud product areas.

What Grafana Cloud areas does the gcx demo cover?

The tour covers providers, K8s-style resources like dashboards and folders, datasources, live metrics, logs, and traces, the Assistant and investigations, SLOs, alert rules and firing instances, synthetic monitoring checks, IRM on-call schedules, and k6 load tests plus fleet pipelines.

Can the gcx demo modify or delete anything on my stack?

No. The demo is strictly read-only and never runs push, create, update, delete, or edit commands. If a command would require write scope, it is skipped with an explanation.

What happens if a command fails during the gcx demo?

Failures are handled gracefully: missing signal datasources, absent cloud tokens, unavailable Assistant access, or 403 scope errors cause that section to be skipped with a brief note. The tour never aborts for a single failure and surfaces errors at the end.

Does the gcx demo work with self-hosted Grafana?

Core resource, datasource, and signal queries work, but the Assistant section is Cloud-only and requires OAuth via gcx login. k6 and fleet commands additionally need cloud.token and cloud.stack configured, otherwise they are skipped.